ResUtilGetMultiSzValue 函式 (resapi.h)

從 叢集資料庫傳回多個字串值。

語法

DWORD WINAPI_INLINE ResUtilGetMultiSzValue(
  [in]            HKEY    hkeyClusterKey,
  [in]            LPCWSTR pszValueName,
  [out, optional] LPWSTR  *ppszOutValue,
  [out]           LPDWORD pcbOutValueSize
);

參數

[in] hkeyClusterKey

索引鍵，識別叢集資料庫中多個字串值的位置。

[in] pszValueName

Null 終止的 Unicode 字串指標，其中包含要擷取的值名稱。

[out, optional] ppszOutValue

所擷取值的指標位址。

[out] pcbOutValueSize

DWORD 的指標，其中會傳回 ppszOutValue 所指向之緩衝區位元組的大小。

傳回值

如果作業成功，函式會傳回 ERROR_SUCCESS。

如果作業失敗，函式會傳回 系統錯誤碼。 以下是可能的錯誤碼。

傳回碼	Description
ERROR_NOT_ENOUGH_MEMORY	記憶體配置期間發生錯誤。

備註

當您完成配置給 ResUtilGetMultiSzValue 公用程式函式所傳回值的記憶體時，您必須呼叫 LocalFree 函式來釋放它。

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目標平台	Windows
標頭	resapi.h

另請參閱

ClusterRegQueryValue

ResUtilGetBinaryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetSzValue