共用方式為

SHOpenRegStream2A 函式 (shlwapi.h)

  • 發行項

開啟登錄值，並提供可用來讀取或寫入值的數據流。 此函式會取代 SHOpenRegStream。

語法

IStream * SHOpenRegStream2A(
  [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 命名的子機碼、沒有足夠許可權的呼叫端可存取子機碼，或無法開啟數據流。

備註

當不再需要 IStream 物件時，呼叫呼叫應用程式會負責呼叫傳回物件的 Release 方法。

注意

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

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 shlwapi.h
程式庫 Shlwapi.lib
Dll Shlwapi.dll (5.0 版或更新版本)