IQueryAssociations::GetData-Methode (shlwapi.h)

  • Artikel

Sucht nach Binärdaten für Datei- oder Protokollzuordnungen und ruft sie aus der Registrierung ab.

Syntax

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

Parameter

[in] flags

Typ: ASSOCF

Der ASSOCF-Wert , der zum Steuern der Suche verwendet werden kann.

[in] data

Typ: ASSOCDATA

Der ASSOCDATA-Wert , der den Typ der zurückzugebenden Daten angibt.

[in, optional] pszExtra

Typ: LPCWSTR

Ein Zeiger auf eine optionale, mit NULL endende Unicode-Zeichenfolge mit Informationen zum Speicherort der Daten. Es wird normalerweise auf ein Shell-Verb festgelegt, z. B. open. Legen Sie diesen Parameter auf NULL fest, wenn er nicht verwendet wird.

[out, optional] pvOut

Typ: void*

Ein Zeiger auf einen Wert, der den angeforderten Datenwert empfängt, wenn diese Methode erfolgreich zurückgibt.

[in, out, optional] pcbOut

Typ: DWORD*

Ein Zeiger auf einen Wert, der beim Aufrufen dieser Methode die Größe von pvOut in Bytes enthält. Wenn diese Methode erfolgreich zurückgegeben wird, enthält der Wert die Größe der tatsächlich abgerufenen Daten.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

IQueryAssociations