ReportSMSStatusMessage – funkce

Funkce ReportSMSStatusMessage v Configuration Manager odešle objekt stavové zprávy do stavového systému Configuration Manager a pak objekt uvolní.

Syntaxe

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

Parametry

hStatusMessageObject Datový typ: HANDLE

Kvalifikátory: [in, out]

Zpracování objektu stavové zprávy Na vstupu zadejte popisovač načtený službou CreateSMSStatusMessage. Při úspěšném návratu z funkce tento parametr obsahuje popisovač uvolněného objektu.

Chování této funkce není definováno pro neplatné popisovače a vyvolá výjimku narušení přístupu. Proto se ujistěte, že pro tento parametr zadáte platný popisovač. Viz Poznámky.

pszComponentName Datový typ: LPCSTR

Kvalifikátory: [v]

Ukazatel na název komponenty, která hlásí stavovou zprávu. Tento název je null-terminated název součásti ASCII. Zobrazí se v Prohlížeči stavových zpráv ve sloupci Komponenta a v systém Windows NT Prohlížeč událostí ve sloupci Kategorie. Další informace najdete v části Poznámky dále v tomto tématu.

pszSiteCode Datový typ: LPCSTR

Kvalifikátory: [v]

Ukazatel na Configuration Manager kód lokality, na který chcete nahlásit stavovou zprávu. Kód je kód ASCII ukončený hodnotou null, který má délku přesně tři znaky. Případně můžete tento parametr nastavit na nullhodnotu . Další informace najdete v části Poznámky dále v tomto tématu.

pszTopLevelSiteCode Datový typ: LPCSTR

Kvalifikátory: [v]

Ukazatel na Configuration Manager kód lokality pro nejvyšší lokalitu v hierarchii, do které lze zprávu replikovat. Kód je kód ASCII ukončený hodnotou null. Alternativně můžete tento parametr nastavit na nullhodnotu . Další informace najdete v části Poznámky dále v tomto tématu.

Návratové hodnoty

Tato funkce vrátí jednu z hodnot v následující tabulce.

Hodnota	Popis
SMSSTATMSG_SUCCESS	Objekt byl úspěšně odeslán do stavového systému Configuration Manager.
SMSSTATMSG_OUT_OF_MEMORY	Této funkci se nepodařilo přidělit dostatek paměti k odeslání objektu do stavového systému Configuration Manager.
SMSSTATMSG_ERROR_INVALID_COMPONENT_NAME	Zadaný volající null nebo řetězec, který překročil délku SMSSTATMSG_MAX_COMPONENT_NAME_LENGTH znaků parametru pszComponentName .
SMSSTATMSG_ERROR_INVALID_SITE_CODE	Volající zadal neplatný řetězec, který není null pro pszSiteCode.
SMSSTATMSG_ERROR_UNKNOWN	Funkce zjistila neznámou chybu při pokusu o odeslání objektu do stavového systému Configuration Manager.
SMSSTATMSG_ERROR_INVALID_TOP_LEVEL_SC	Volající zadal neplatný řetězec, který není null pro pszTopLevelSiteCode.
SMSSTATMSG_ERROR_NOT_SMS_CLIENT	Této funkci se nepodařilo odeslat objekt do stavového systému Configuration Manager, protože Configuration Manager klientský software není v tomto počítači správně nainstalován.

Poznámky

Smscstat.h obsahuje následující #define pro volání ReportSMSStatusMessage pomocí funkce GetProcAddressWin32 .

#define PROCNAME_REPORTSMSSTATUSMESSAGE "ReportSMSStatusMessage"

Při volání této funkce použijte hStatusMessageObject parametr k zadání popisovače pro hlášení stavové zprávy. Když se tato funkce vrátí, je zaručeno, že načtený objekt bude uvolněn bez ohledu na úspěch funkce. Pokud je funkce neúspěšná a chcete, aby se aplikace pokusila znovu, vytvořte před voláním ReportSMSStatusMessagenovou stavovou zprávu.

Pomocí parametru pszComponentName této funkce zadejte název komponenty, která hlásí stavovou zprávu. Tento název nelze lokalizovat do jiných jazyků, protože správce Configuration Manager vytváří dotazy a pravidla filtrování založená na názvu komponenty. To správci pomůže rychle načíst konkrétní stavové zprávy a nakonfigurovat Configuration Manager, aby tyto stavové zprávy zpracovávaly zvláštními způsoby.

V parametru pszSiteCode zadejte kód pro Configuration Manager web, na který se má zpráva odeslat. Kód musí být pro jednu z lokalit, ke kterým aktuálně patří klient Configuration Manager. Obecně byste pro tento parametr měli zadatnull, že stavová zpráva by měla být hlášena všem Configuration Manager lokalitám, do kterých patří klient Configuration Manager.

Stavový systém zastaví replikaci v lokalitě označené správcem pszTopLevelSiteCode bez ohledu na to, jak správce nakonfiguroval pravidla replikace. Obecně byste pro tento parametr měli určit null , že neexistuje žádný kód lokality nejvyšší úrovně a že se zpráva může replikovat až do horní části hierarchie. Pokud však existuje důvod zabránit replikaci přes určitou lokalitu, můžete kód lokality této lokality zadat pomocí parametru pszTopLevelSiteCode .

Požadavky

Smscstat.dll.

Požadavky na modul runtime

Další informace najdete v tématu Configuration Manager Požadavky na modul runtime klienta.

Požadavky na vývoj

Další informace najdete v tématu Configuration Manager Požadavky na vývoj klientů.

Viz taky

funkceSMSCSTAT.DLL stavových zpráv