共用方式為

SHOpenRegStreamA 函式 （shlwapi.h）

  • 發行項

荒廢的。 開啟登錄值，並提供可用來讀取或寫入值的數據流。

注意 此函式已由 SHOpenRegStream2取代。 建議您隨時使用 SHOpenRegStream2。
 

語法

IStream * SHOpenRegStreamA(
  [in]           HKEY   hkey,
  [in, optional] LPCSTR pszSubkey,
  [in, optional] LPCSTR pszValue,
  [in]           DWORD  grfMode
);

參數

[in] hkey

類型：HKEY

必填。 包含值的子樹，例如 HKEY_LOCAL_MACHINE。

[in, optional] pszSubkey

類型：LPCTSTR

自選。 Null 終止字串的指標，指定包含值的子機碼。 這個值可以 NULL。

[in, optional] pszValue

類型：LPCTSTR

Null 終止字串的指標，指定要存取的值。 這個值可以 NULL。

[in] grfMode

類型：DWORD

數據流的存取類型。 這可以是下列其中一個值：

STGM_READ

開啟要讀取的數據流。

STGM_WRITE

開啟要寫入的數據流。

STGM_READWRITE

開啟數據流以進行讀取和寫入。

傳回值

類型：IStream*

如果成功，會傳回 IStream 介面指標;否則，NULL。 NULL 值可能是由數種情況所造成，包括無效的 hkey 或 pszSubkey ，或無法開啟數據流。

注意 在某些情況下，例如，當由 pszSubkey 命名的子機碼 不存在或呼叫端沒有足夠的許可權存取子機碼時，會傳回長度為零的數據流，而不是 NULL 值。 SHOpenRegStream2 在所有錯誤情況下都會傳回 NULL，因此是慣用的函式。
 

言論

呼叫端應用程式負責呼叫傳回物件的 Release 方法，而不再需要該 IStream 物件。

注意

shlwapi.h 標頭會將SHOpenRegStream定義為別名，根據UNICODE預處理器常數的定義，自動選取此函式的ANSI或Unicode版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 shlwapi.h
連結庫 Shlwapi.lib
DLL Shlwapi.dll （4.71 版或更新版本）