ReportSMSStatusMessage 函式

在Configuration Manager中,函 ReportSMSStatusMessage 式會將狀態訊息物件提交至Configuration Manager狀態系統,然後解除配置物件。

語法

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

參數

hStatusMessageObject
資料類型:HANDLE

限定詞:[in, out]

狀態訊息物件的控制碼。 在輸入時,提供 CreateSMSStatusMessage所擷取的控制碼。 從函式成功傳回時,此參數會包含已解除配置物件的控制碼。

此函式的行為未定義為不正確控制碼,並擲回存取違規例外狀況。 因此,請確定您提供此參數的有效控制碼。 請參閱<備註>。

pszComponentName
資料類型:LPCSTR

限定詞:[in]

報告狀態訊息之元件名稱的指標。 此名稱是以 Null 結尾的 ASCII 元件名稱。 它會出現在 [元件] 資料行的 [狀態訊息檢視器] 中,並出現在 [類別] 資料行的 [Windows NT 事件檢視器中。 如需詳細資訊,請參閱本主題稍後的一節。

pszSiteCode
資料類型:LPCSTR

限定詞:[in]

要報告狀態訊息之月臺Configuration Manager月臺碼的指標。 程式碼是以 Null 結尾的 ASCII 程式碼,其長度剛好是三個字元。 或者,您可以將此參數設定為 null 。 如需詳細資訊,請參閱本主題稍後的一節。

pszTopLevelSiteCode
資料類型:LPCSTR

限定詞:[in]

階層中可複寫訊息之最高月臺的Configuration Manager月臺碼指標。 此程式碼是以 Null 結尾的 ASCII 程式碼。 或者,您可以將此參數設定為 null 。 如需詳細資訊,請參閱本主題稍後的一節。

傳回值

此函式會傳回下表中的其中一個值。

描述
SMSSTATMSG_SUCCESS 物件已成功提交至Configuration Manager狀態系統。
SMSSTATMSG_OUT_OF_MEMORY 此函式無法配置足夠的記憶體,以將物件提交至Configuration Manager狀態系統。
SMSSTATMSG_ERROR_INVALID_COMPONENT_NAME 提供的 null 呼叫端或超出參數長度SMSSTATMSG_MAX_COMPONENT_NAME_LENGTH字元的 pszComponentName 字串。
SMSSTATMSG_ERROR_INVALID_SITE_CODE 呼叫端為 提供了非 Null 無效字串 pszSiteCode
SMSSTATMSG_ERROR_UNKNOWN 函式嘗試將物件提交至Configuration Manager狀態系統時發生未知的錯誤。
SMSSTATMSG_ERROR_INVALID_TOP_LEVEL_SC 呼叫端為 提供了非 Null 無效字串 pszTopLevelSiteCode
SMSSTATMSG_ERROR_NOT_SMS_CLIENT 此函式無法將物件提交至Configuration Manager狀態系統,因為Configuration Manager用戶端軟體未正確安裝在此電腦上。

註解

Smscstat.h 包含下列使用 Win32 函 GetProcAddress 式 呼叫 ReportSMSStatusMessage 的#define。

#define PROCNAME_REPORTSMSSTATUSMESSAGE "ReportSMSStatusMessage"  

呼叫此函式時,請使用 hStatusMessageObject 參數來提供要報告之狀態訊息的控制碼。 當此函式傳回時,不論函式是否成功,都保證會解除配置擷取的物件。 如果函式不成功,而且您想要讓應用程式再試一次,請在呼叫 ReportSMSStatusMessage 之前建立新的狀態訊息。

pszComponentName使用此函式的 參數,為報告狀態訊息的元件提供名稱。 此名稱無法當地語系化為其他語言,因為Configuration Manager系統管理員會根據元件名稱建立查詢和篩選規則。 這可協助系統管理員快速擷取您的特定狀態訊息,並設定Configuration Manager以特殊方式處理這些狀態訊息。

在 參數中 pszSiteCode ,提供要提交訊息之Configuration Manager月臺的程式碼。 程式碼必須適用于Configuration Manager用戶端目前所屬的其中一個月臺。 一般而言,您應該提供 null 此參數,以指出狀態訊息應該回報給Configuration Manager用戶端所屬的所有Configuration Manager月臺。

無論系統管理員如何設定複寫規則,狀態系統都會停止站 pszTopLevelSiteCode 臺上的複寫。 一般而言,您應該為此參數指定 null ,以指出沒有最上層月臺碼,而且訊息可以自由地複寫到階層頂端。 不過,如果無法複寫超過特定月臺,您可以使用 參數來提供該網站的 pszTopLevelSiteCode 月臺碼。

需求

Smscstat.dll。

執行時間需求

如需詳細資訊,請參閱Configuration Manager用戶端執行時間需求。

開發需求

如需詳細資訊,請參閱Configuration Manager用戶端開發需求。

另請參閱

SMSCSTAT.DLL狀態訊息函式