Função SHRegGetPathW (shlwapi.h)

Recupera um caminho de arquivo do registro, expandindo variáveis de ambiente conforme necessário.

Sintaxe

LSTATUS SHRegGetPathW(
  [in]  HKEY    hKey,
  [in]  LPCWSTR pcszSubKey,
  [in]  LPCWSTR pcszValue,
  [out] LPWSTR  pszPath,
        DWORD   dwFlags
);

Parâmetros

[in] hKey

Tipo: HKEY

Um identificador para uma chave que está aberta no momento ou uma chave raiz do Registro.

[in] pcszSubKey

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome da subchave.

[in] pcszValue

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do valor que contém a cadeia de caracteres de caminho não inicializada.

[out] pszPath

Tipo: LPTSTR

Um buffer para manter o caminho expandido. Você deve definir o tamanho desse buffer como MAX_PATH para garantir que ele seja grande o suficiente para manter a cadeia de caracteres retornada.

dwFlags

Tipo: DWORD

Reservado.

Valor de retorno

Tipo: LSTATUS

Retorna ERROR_SUCCESS se tiver êxito ou um código de erro do Windows de outra forma.

Observações

O tipo de dados do valor do Registro especificado deve ser REG_EXPAND_SZ ou REG_SZ. Se ele tiver o tipo REG_EXPAND_SZ, todas as variáveis de ambiente na cadeia de caracteres do Registro serão expandidas com ExpandEnvironmentStrings. Se ele tiver o tipo de dados REG_SZ, as variáveis de ambiente não serão expandidas e a cadeia de caracteres apontada por pszPath será idêntica à cadeia de caracteres no registro.

As cadeias de caracteres de ambiente a seguir serão substituídas pelo caminho equivalente.

Requisitos