Funzione ReportSMSStatusMessage

La ReportSMSStatusMessage funzione, in Configuration Manager, invia un oggetto messaggio di stato al sistema di stato Configuration Manager e quindi dealloca l'oggetto.

Sintassi

[C/C++]
typedef DWORD (WINAPI *PROC_REPORTSMSSTATUSMESSAGE)
(
      HANDLE hStatusMessageObject,
      LPCSTR pszComponentName,
      LPCSTR pszSiteCode,
      LPCSTR pszTopLevelSiteCode
);

Parametri

hStatusMessageObject Tipo di dati: HANDLE

Qualificatori: [in, out]

Gestire l'oggetto messaggio di stato. All'input specificare l'handle recuperato da CreateSMSStatusMessage. Al termine della restituzione dalla funzione, questo parametro contiene l'handle per l'oggetto deallocato.

Il comportamento di questa funzione non è definito per gli handle non validi e genera un'eccezione di violazione di accesso. Assicurarsi pertanto di fornire un handle valido per questo parametro. Vedere le Note.

pszComponentName Tipo di dati: LPCSTR

Qualificatori: [in]

Puntatore al nome del componente che segnala il messaggio di stato. Questo nome è un nome del componente ASCII con terminazione Null. Viene visualizzato in Visualizzatore messaggi di stato nella colonna Componente e in Windows NT Visualizzatore eventi nella colonna Categoria. Per altre informazioni, vedere la sezione Osservazioni più avanti in questo argomento.

pszSiteCode Tipo di dati: LPCSTR

Qualificatori: [in]

Puntatore al codice del sito Configuration Manager per il sito a cui segnalare il messaggio di stato. Il codice è un codice ASCII con terminazione Null lungo esattamente tre caratteri. In alternativa, è possibile impostare questo parametro su null. Per altre informazioni, vedere la sezione Osservazioni più avanti in questo argomento.

pszTopLevelSiteCode Tipo di dati: LPCSTR

Qualificatori: [in]

Puntatore al codice del sito Configuration Manager per il sito più alto nella gerarchia in cui è possibile replicare il messaggio. Il codice è un codice ASCII con terminazione Null. In alternativa, è possibile impostare questo parametro su null. Per altre informazioni, vedere la sezione Osservazioni più avanti in questo argomento.

Valori restituiti

Questa funzione restituisce uno dei valori nella tabella seguente.

Valore Descrizione
SMSSTATMSG_SUCCESS L'oggetto è stato inviato correttamente al sistema di stato Configuration Manager.
SMSSTATMSG_OUT_OF_MEMORY Questa funzione non è riuscita ad allocare memoria sufficiente per inviare l'oggetto al sistema di stato Configuration Manager.
SMSSTATMSG_ERROR_INVALID_COMPONENT_NAME Il chiamante fornito null o una stringa che ha superato SMSSTATMSG_MAX_COMPONENT_NAME_LENGTH caratteri di lunghezza per il pszComponentName parametro.
SMSSTATMSG_ERROR_INVALID_SITE_CODE Il chiamante ha fornito una stringa non NULL non valida per pszSiteCode.
SMSSTATMSG_ERROR_UNKNOWN La funzione ha rilevato un errore sconosciuto durante il tentativo di inviare l'oggetto al sistema di stato Configuration Manager.
SMSSTATMSG_ERROR_INVALID_TOP_LEVEL_SC Il chiamante ha fornito una stringa non NULL non valida per pszTopLevelSiteCode.
SMSSTATMSG_ERROR_NOT_SMS_CLIENT Questa funzione non è riuscita a inviare l'oggetto al sistema di stato Configuration Manager perché il software client Configuration Manager non è installato correttamente nel computer.

Osservazioni

Smscstat.h include le #define seguenti per la chiamata ReportSMSStatusMessage tramite la funzione GetProcAddressWin32 .

#define PROCNAME_REPORTSMSSTATUSMESSAGE "ReportSMSStatusMessage"

Quando si chiama questa funzione, usare il hStatusMessageObject parametro per fornire un handle per il messaggio di stato da segnalare. Quando questa funzione termina, l'oggetto recuperato viene sicuramente deallocato, indipendentemente dall'esito positivo della funzione. Se la funzione non riesce e si vuole che l'applicazione provi di nuovo, creare un nuovo messaggio di stato prima di chiamare ReportSMSStatusMessage.

Usare il pszComponentName parametro di questa funzione per specificare un nome per il componente che segnala il messaggio di stato. Questo nome non è localizzabile in altre lingue, perché l'amministratore Configuration Manager crea query e filtra le regole basate sul nome del componente. Ciò consente all'amministratore di recuperare rapidamente i messaggi di stato specifici e di configurare Configuration Manager per gestire questi messaggi di stato in modi speciali.

pszSiteCode Nel parametro specificare il codice per il sito Configuration Manager a cui inviare il messaggio. Il codice deve essere per uno dei siti a cui appartiene attualmente il client Configuration Manager. In genere, è necessario specificare null per questo parametro, per indicare che il messaggio di stato deve essere segnalato a tutti i siti Configuration Manager a cui appartiene il client Configuration Manager.

Il sistema di stato arresta la replica nel sito indicato indipendentemente dal pszTopLevelSiteCode modo in cui l'amministratore ha configurato le regole di replica. In genere, è necessario specificare null per questo parametro, per indicare che non esiste alcun codice del sito di primo livello e che il messaggio è libero di replicare fino all'inizio della gerarchia. Tuttavia, se esiste un motivo per impedire la replica oltre un determinato sito, è possibile specificare il codice del sito di tale sito usando il pszTopLevelSiteCode parametro .

Requisiti

Smscstat.dll.

Requisiti di runtime

Per altre informazioni, vedere requisiti di runtime del client Configuration Manager.

Requisiti di sviluppo

Per altre informazioni, vedere Configuration Manager Requisiti di sviluppo client.

Vedere anche

Funzioni dei messaggi di statoSMSCSTAT.DLL

  • Last updated on