Edit

Share via

IQueryAssociations::GetData method (shlwapi.h)

  • Article

Searches for and retrieves file or protocol association-related binary data from the registry.

Syntax

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

Parameters

[in] flags

Type: ASSOCF

The ASSOCF value that can be used to control the search.

[in] data

Type: ASSOCDATA

The ASSOCDATA value that specifies the type of data that is to be returned.

[in, optional] pszExtra

Type: LPCWSTR

A pointer to an optional, null-terminated Unicode string with information about the location of the data. It is normally set to a Shell verb such as open. Set this parameter to NULL if it is not used.

[out, optional] pvOut

Type: void*

A pointer to a value that, when this method returns successfully, receives the requested data value.

[in, out, optional] pcbOut

Type: DWORD*

A pointer to a value that, when this method is called, holds the size of pvOut, in bytes. When this method returns successfully, the value contains the size of the data actually retrieved.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shlwapi.h
Library Shlwapi.lib
DLL Shell32.dll (version 5.0 or later)

See also

IQueryAssociations