Função SHOpenRegStream2A (shlwapi.h)

Artigo
11/20/2024

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 * SHOpenRegStream2A(
  [in]           HKEY   hkey,
  [in, optional] LPCSTR pszSubkey,
  [in, optional] LPCSTR pszValue,
  [in]           DWORD  grfMode
);

Parâmetros

[in] hkey

Tipo: HKEY

Necessário. 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 pode ser um dos seguintes valores:

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.

Valor de retorno

Tipo: * IStream

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

Observações

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

Nota

O cabeçalho shlwapi.h define SHOpenRegStream2 como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shlwapi.h
biblioteca	Shlwapi.lib
de DLL	Shlwapi.dll (versão 5.0 ou posterior)

Compartilhar via