Compartilhar via


Método IQueryAssociations::GetData (shlwapi.h)

Pesquisa e recupera dados binários relacionados à associação de arquivo ou protocolo do registro.

Sintaxe

HRESULT GetData(
  [in]                ASSOCF    flags,
  [in]                ASSOCDATA data,
  [in, optional]      LPCWSTR   pszExtra,
  [out, optional]     void      *pvOut,
  [in, out, optional] DWORD     *pcbOut
);

Parâmetros

[in] flags

Tipo: ASSOCF

O valor ASSOCF que pode ser usado para controlar a pesquisa.

[in] data

Tipo: ASSOCDATA

O valor ASSOCDATA que especifica o tipo de dados que deve ser retornado.

[in, optional] pszExtra

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres Unicode opcional terminada em nulo com informações sobre o local dos dados. Normalmente, ele é definido como um verbo Shell, como aberto. Defina esse parâmetro como NULL se ele não for usado.

[out, optional] pvOut

Tipo: void*

Um ponteiro para um valor que, quando esse método retorna com êxito, recebe o valor de dados solicitado.

[in, out, optional] pcbOut

Tipo: DWORD*

Um ponteiro para um valor que, quando esse método é chamado, contém o tamanho de pvOut, em bytes. Quando esse método retorna com êxito, o valor contém o tamanho dos dados realmente recuperados.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

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

Confira também

IQueryAssociations