SHRegGetValueFrom HKCU HKLM 函式 (shlwapi.h)

[不再支援此函式。]

從登錄取得指定的資訊。 此函式會檢查HKEY_CURRENT_USER指定子機碼中所要求的資訊。 如果資訊不存在於HKEY_CURRENT_USER子樹底下，函式會檢查HKEY_LOCAL_MACHINE子樹中是否有相同的資訊。

語法

LSTATUS SHRegGetValueFromHKCUHKLM(
  [in]      PCWSTR pwszKey,
  [in]      PCWSTR pwszValue,
  [in]      SRRF   srrfFlags,
  [out]     DWORD  *pdwType,
  [in]      void   *pvData,
  [in, out] DWORD  *pcbData
);

參數

[in] pwszKey

類型： PCWSTR

指定登錄機碼路徑之 Null終止 Unicode 字串的指標。

[in] pwszValue

類型： PCWSTR

指定索引鍵值的 Null終止 Unicode 字串指標。 此值可以是 Null，在此情況下，會從預設值擷取資料。

[in] srrfFlags

類型： SRRF

SRRF旗標常數。 如果使用多個旗標，則可以使用位 OR 合併。 這些旗標可用來限制傳回的資料類型。 這個值不能是 0。

[out] pdwType

類型： DWORD*

當此函式傳回時，會包含 DWORD 的指標，該指標會接收表示儲存在指定值中的資料類型的程式碼。 如果沒有想要類型資訊，這可以設定為 Null 。 如果這個值不是 Null，而且尚未設定SRRF_NOEXPAND旗標，REG_EXPAND_SZ的資料類型將會傳回為REG_SZ，因為它們會自動在此方法中展開。

[in] pvData

類型： LPCVOID

緩衝區的指標，其中包含值的資料。 如果不需要資料，此參數可以是 Null 。 此值必須包含專案上的 pvData 緩衝區大小。 如果 pvData 是 Null (，或 pvData 不是 Null，但緩衝區太小而無法保存登錄資料) ，則結束時會包含保存登錄資料所需的大小。

[in, out] pcbData

類型： DWORD*

當此函式傳回時，會以位元組為單位，包含資料大小的指標。

傳回值

類型： LONG

如果成功，此函式會傳回ERROR_SUCCESS和要求的所有輸出參數。 如果函式因提供的非Null pvData 空間不足而失敗，則傳回ERROR_MORE_DATA。 在此情況下，只有 pdwType 和 wwwData 可能包含有效的資料， pvData 將會未定義。 否則，傳回 Winerror.h 中定義的非零錯誤碼。 您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標來擷取錯誤的泛型描述。

需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	shlwapi.h
Dll	Shlwapi.dll