Função OpenRegStream (shlobj_core.h)

[O OpenRegStream está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use SHOpenRegStream2 ou SHOpenRegStream.]

Abre um valor do Registro e fornece uma interface IStream que pode ser usada para ler ou gravar no valor.

Sintaxe

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

Parâmetros

[in] hkey

Tipo: HKEY

Um identificador para a chave que está aberta no momento.

[in, optional] pszSubkey

Tipo: PCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que especifica o nome da subchave.

[in, optional] pszValue

Tipo: PCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que especifica o valor a ser acessado.

grfMode

Tipo: DWORD

O tipo de acesso para o fluxo. Esse pode ser um dos valores a seguir.

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 o endereço de uma interface IStream se tiver êxito ou NULL caso contrário.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj_core.h (inclua Shlobj.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 5.0 ou posterior)