Função MsiGetComponentPathExA (msi.h)

A função MsiGetComponentPathEx retorna o caminho completo para um componente instalado. Se o caminho da chave do componente for uma chave do Registro, a função retornará a chave do Registro.

Essa função estende a função MsiGetComponentPath existente para habilitar pesquisas de componentes entre contas de usuário e contextos de instalação.

Sintaxe

INSTALLSTATE MsiGetComponentPathExA(
  [in]                LPCSTR            szProductCode,
  [in]                LPCSTR            szComponentCode,
  [in, optional]      LPCSTR            szUserSid,
  [in, optional]      MSIINSTALLCONTEXT dwContext,
  [out, optional]     LPSTR             lpOutPathBuffer,
  [in, out, optional] LPDWORD           pcchOutPathBuffer
);

Parâmetros

[in] szProductCode

Um valor de cadeia de caracteres terminada em nulo que especifica o GUID do código do produto de um aplicativo. A função obtém o caminho dos componentes instalados usados por este aplicativo.

[in] szComponentCode

Um valor de cadeia de caracteres terminada em nulo que especifica um GUID de código de componente. A função obtém o caminho de um componente instalado com esse código de componente.

[in, optional] szUserSid

Um valor de cadeia de caracteres terminada em nulo que especifica o SID (identificador de segurança) de um usuário no sistema. A função obtém os caminhos dos componentes instalados dos aplicativos instalados nas contas de usuário identificadas por esse SID. A cadeia de caracteres sid especial s-1-1-0 (Todos) especifica todos os usuários no sistema. Se esse parâmetro for NULL, a função obterá o caminho de um componente instalado somente para o usuário conectado no momento.

[in, optional] dwContext

Um sinalizador que especifica o contexto de instalação. A função obtém os caminhos dos componentes instalados dos aplicativos instalados no contexto de instalação especificado. Esse parâmetro pode ser uma combinação dos seguintes valores.

[out, optional] lpOutPathBuffer

Um valor de cadeia de caracteres que recebe o caminho para o componente. Este parâmetro pode ser NULL. Se o componente for uma chave do Registro, as raízes do Registro serão representadas numericamente. Se esse for um caminho de subchave do Registro, haverá uma barra invertida no final do Caminho da Chave. Se esse for um caminho de chave de valor do Registro, não haverá barra invertida no final. Por exemplo, um caminho do Registro em um sistema operacional de 32 bits do software HKEY_CURRENT_USER\\Microsoft é retornado como "01:\SOFTWARE\Microsoft". As raízes do registro retornadas em sistemas operacionais de 32 bits são definidas conforme mostrado na tabela a seguir.

[in, out, optional] pcchOutPathBuffer

Ponteiro para um local que recebe o tamanho do buffer, em TCHAR, apontado pelo parâmetro szPathBuf . O valor nesse local deve ser definido como a contagem de TCHAR na cadeia de caracteres, incluindo o caractere nulo de terminação. Se o tamanho do buffer for muito pequeno, esse parâmetro receberá o comprimento do valor da cadeia de caracteres sem incluir o caractere nulo de terminação na contagem.

Retornar valor

A função MsiGetComponentPathEx retorna os valores a seguir.

Comentários

A função MsiGetComponentPathEx pode retornar INSTALLSTATE_ABSENT ou INSTALL_STATE_UNKNOWN, pelos seguintes motivos:

• INSTALLSTATE_ABSENT

  O aplicativo não garantiu corretamente que o recurso foi instalado chamando MsiUseFeature e, se necessário, MsiConfigureFeature.

• INSTALLSTATE_UNKNOWN

  O recurso não foi publicado. O aplicativo deve ter determinado isso anteriormente chamando MsiQueryFeatureState ou MsiEnumFeatures. O aplicativo faz essas chamadas enquanto inicializa. Um aplicativo só deve usar recursos que são conhecidos por serem publicados. Como INSTALLSTATE_UNKNOWN deveria ter sido retornado por MsiUseFeature também, MsiUseFeature não foi chamado ou seu valor retornado não foi verificado corretamente.

Requisitos

Confira também

Funções específicas do componente