IQueryAssociations::GetData 方法 (shlwapi.h)

搜尋並擷取登錄中的檔案或通訊協定關聯相關二進位數據。

語法

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

參數

[in] flags

類型: ASSOCF

可用來控制搜尋的 ASSOCF 值。

[in] data

類型: ASSOCDATA

ASSOCDATA 值,指定要傳回之數據類型。

[in, optional] pszExtra

類型: LPCWSTR

選擇性、以 Null 終止的 Unicode 字串指標,其中包含數據位置的相關信息。 它通常會設定為Shell動詞命令,例如 open。 如果未使用此參數,請將此參數設定為 NULL

[out, optional] pvOut

類型: void*

值指標,當這個方法成功傳回時,會收到要求的數據值。

[in, out, optional] pcbOut

類型: DWORD*

呼叫此方法時,會以位元組為單位保留 pvOut 大小的值指標。 當這個方法成功傳回時,值會包含實際擷取的數據大小。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 shlwapi.h
程式庫 Shlwapi.lib
Dll Shell32.dll (5.0 版或更新版本)

另請參閱

IQueryAssociations