Função SHOpenRegStream2W (shlwapi.h)

Abre um valor do Registro e fornece um fluxo que pode ser usado para ler ou gravar no valor. Essa função substitui SHOpenRegStream.

Sintaxe

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

Parâmetros

[in] hkey

Tipo: HKEY

Obrigatórios. A subárvore, como HKEY_LOCAL_MACHINE, que contém o valor .

[in, optional] pszSubkey

Tipo: LPCTSTR

Opcional. Ponteiro para uma cadeia de caracteres terminada em nulo que especifica a subchave que contém o valor. Esse valor pode ser NULL.

[in, optional] pszValue

Tipo: LPCTSTR

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o valor a ser acessado. Esse valor pode ser NULL.

[in] grfMode

Tipo: DWORD

O tipo de acesso para o fluxo. Esse valor pode ser um dos seguintes:

STGM_READ

Abra o fluxo para leitura.

STGM_WRITE

Abra o fluxo para gravação.

STGM_READWRITE

Abra o fluxo para leitura e gravação.

Retornar valor

Tipo: IStream*

Retorna um ponteiro de interface IStream se for bem-sucedido; caso contrário, NULL. Um valor NULL pode ser causado por várias situações, incluindo um hkey ou pszSubkey inválido, uma subchave chamada por pszSubkey que não existe, um chamador sem permissões suficientes para acessar a subchave ou uma incapacidade de abrir o fluxo.

Comentários

O aplicativo de chamada é responsável por chamar o método Release do objeto retornado quando esse objeto IStream não é mais necessário.

Requisitos