共用方式為

IOleUIObjInfoA：：GetObjectInfo 方法 (oledlg.h)

  • 發行項

取得物件的大小、類型、名稱和位置資訊。

語法

HRESULT GetObjectInfo(
  [in]            DWORD dwObject,
  [out]           DWORD *lpdwObjSize,
  [out, optional] LPSTR *lplpszLabel,
  [out, optional] LPSTR *lplpszType,
  [out, optional] LPSTR *lplpszShortType,
  [out, optional] LPSTR *lplpszLocation
);

參數

[in] dwObject

物件的唯一標識碼。

[out] lpdwObjSize

磁碟上物件大小的指標，以位元組為單位。 這可能是近似值。

[out, optional] lplpszLabel

接收物件標籤字串指標的指標變數位址。 這個參數可能是 NULL ，表示實作不應該傳回標籤字串。

[out, optional] lplpszType

接收物件之長型別字串指標的指標變數位址。 這個參數可能是 NULL ，表示實作不應該傳回長型別字串。

[out, optional] lplpszShortType

接收物件簡短型別字串指標的指標變數位址。 這個參數可能是 NULL ，表示實作不應該傳回簡短型別字串。

[out, optional] lplpszLocation

接收物件來源位置字串指標的指標變數位址。 這個參數可能是 NULL ，表示實作不應該傳回位置字串。

傳回值

此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼 Description
E_FAIL
 作業失敗。
E_INVALIDARG
 指定的識別碼無效。
E_OUTOFMEMORY
 此作業的記憶體不足。

備註

字串和物件的大小會顯示在物件屬性 [ 一般 ] 頁面中。

實作者的注意事項

您的 GetObjectInfo 實作應該將每個物件的屬性放在提供的 out 參數中。 當物件的大小未知時，請將 lpdwObjSize 設定為 (DWORD) -1。 使用 透過 CoGetMalloc 取得的 OLE 工作配置器，配置所有字串 (其餘的 params) ，如同所有具有 [out] 字元串參數之 OLE 介面的標準，或者您只要使用 CoTaskMemAlloc 即可。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 oledlg.h

另請參閱

CoGetMalloc

CoTaskMemAlloc

IOleUIObjInfo