AddAttributeToSMSStatusMessage – funkce

V Configuration Manager funkce přidá do objektu AddAttributeToSMSStatusMessage stavové zprávy jeden volitelný pár ID/hodnota atributu stavové zprávy.

Syntaxe

[C/C++]
typedef DWORD (WINAPI *PROC_ADDATTRIBUTETOSMSSTATUSMESSAGE)
(
      HANDLE hStatusMessageObject,
      DWORD  dwAttributeID,
      LPCSTR pszAttributeValue
);

Parametry

hStatusMessageObject Datový typ: HANDLE

Kvalifikátory: [v]

Zpracování objektu stavové zprávy

dwAttributeID Datový typ: DWORD

Kvalifikátory: [v]

ID atributu stavové zprávy

pszAttributeValue Datový typ: LPCSTR

Kvalifikátory: [v]

Hodnota atributu stavové zprávy

Návratové hodnoty

Jedna z hodnot v následující tabulce.

Hodnota	Popis
SMSSTATMSG_SUCCESS	Do objektu se úspěšně přidal pár ID/hodnota atributu.
SMSSTATMSG_OUT_OF_MEMORY	Této funkci se nepodařilo přidělit dostatek paměti pro přidání dvojice ID/hodnota atributu k objektu.
STATMSG_ERROR_INVALID_ATTR_VALUE	Zadaný volající null nebo řetězec, který překročil délku SMSSTATMSG_MAX_ATTR_VALUE_LENGTH znaků parametru pszAttributeValue.
SMSSTATMSG_ERROR_MAX_ATTR_LIMIT	Objekt už má přidružené SMSSTATMSG_MAX_NUM_ATTRS páry ID/hodnota atributu, což je maximální povolený počet.
SMSSTATMSG_ERROR_UNKNOWN	Při pokusu o přidání dvojice ID/hodnota atributu došlo k neznámé chybě.

Poznámky

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

#define PROCNAME_ADDATTRIBUTETOSMSSTATUSMESSAGE "AddAttributeToSMSStatusMessage"

Všechny Configuration Manager stavové zprávy obsahují sadu povinných vlastností, jako je název komponenty, která zprávu ohlásila, ID zprávy, čas nahlášení zprávy a řetězce vložení zprávy. Tyto povinné vlastnosti se inicializují při vytvoření objektu stavové zprávy a parametry předané do funkcí rozhraní API pro generování sestav stavových zpráv. Kromě povinných vlastností má stavová zpráva přidružené nula nebo více volitelných vlastností. Ve stavovém systému Configuration Manager se tyto volitelné vlastnosti nazývají páry ID/hodnota atributu nebo jednoduše atributy. V Prohlížeči stavových zpráv se tyto volitelné vlastnosti zobrazí v poli Vlastnosti , když poklikáním na stavovou zprávu otevřete pole Podrobnosti stavové zprávy .

Páry ID/hodnota atributu jsou přidruženy ke stavovým zprávám, aby se usnadnila konstrukce efektivních dotazů na stavové zprávy. Pokud například některá komponenta Configuration Manager hlásí stavovou zprávu související s konkrétním balíčkem Configuration Manager (objekt distribuce softwaru), obsahuje stavová zpráva ID balíčku jako pár ID/hodnota atributu. Správce může spustit dotaz, který načte všechny stavové zprávy přidružené k balíčku. Tabulky stavových zpráv v databázi Configuration Manager SQL Server jsou indexovány, aby bylo možné efektivně načítat zprávy pomocí párů ID/hodnota atributu.

Pár ID/hodnota atributu DWORD se skládá z typu jako ID atributu a řetězce ASCII ukončeného hodnotou null jako dat atributu. Možná ID atributů jsou uvedena v následující tabulce. Tato ID aktuálně určují všechny identifikátory objektů, které jsou specifické pro Configuration Manager přidružené k funkcím distribuce softwaru Configuration Manager. Pokud se vaše aplikace neimegruje s funkcemi distribuce softwaru, je vysoce nepravděpodobné, že budete muset ke stavovým zprávám přidružit nějaké páry ID/hodnota atributu. Proto je vysoce nepravděpodobné, že byste někdy potřebovali tuto funkci volat z aplikace.

Hodnota	Popis
SMSSTATMSG_ATTR_ID_PACKAGE_ID (400)	Hodnota atributu je osmimísídné ID balíčku Configuration Manager.
SMSSTATMSG_ATTR_ID_ADVERTISEMENT_ID (401)	Hodnota atributu je osmimístní ID Configuration Manager inzerování.
SMSSTATMSG_ATTR_ID_COLLECTION_ID (402)	Hodnota atributu je osmiznakový IDENTIFIKÁTOR kolekce Configuration Manager.
SMSSTATMSG_ATTR_ID_USER_NAME (403)	Hodnota atributu je systém Windows NT uživatelské jméno a doména formuláře doména\uživatelské jméno. V situacích, kdy doména není k dispozici, má hodnota atributu podobu samotného uživatelského jména.
SMSSTATMSG_ATTR_ID_DISTRIBUTION_POINT (404)	Hodnota atributu je Configuration Manager cesta NAL pro Configuration Manager distribuční bod.

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

SMSCSTAT.DLL Funkce stavových zprávCreateSMSStatusMessage