IWbemPath::GetNamespaceAt 方法 (wmiutils.h)
IWbemPath::GetNamespaceAt 方法會根據其索引擷取命名空間。 路徑中最左邊的命名空間具有 0 的索引,每個命名空間都移至右邊,且索引值會逐漸提高。
語法
HRESULT GetNamespaceAt(
[in] ULONG uIndex,
[in, out] ULONG *puNameBufLength,
[in, out] LPWSTR pName
);
參數
[in] uIndex
要讀取之命名空間的索引。 路徑中最左邊的命名空間是索引 0,右邊的每個命名空間都有漸進式較高的索引值。 允許的最大值是小於目前命名空間數目的一個。
[in, out] puNameBufLength
呼叫端會將此設定為緩衝區可以保留的字元數。 成功時,這會設定為複製到緩衝區的字元數,包括 NULL 終止符。
[in, out] pName
命名空間名稱。
傳回值
這個方法會傳回 HRESULT ,指出方法呼叫的狀態。
備註
這個方法可用來判斷 pName 需要多少個緩衝區。 這是藉由傳入緩衝區的 NULL 指標、將 puNameBufLength 設定為 0,然後進行呼叫來完成。 傳回時, puNameBufLength 會指出 pName 及其終止 NULL 字元所需的緩衝區大小。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | wmiutils.h |
程式庫 | Wbemuuid.lib |
Dll | Wmiutils.dll |