GetConvertStg 函式 (coml2api.h)

GetConvertStg 函式會傳回指定儲存物件之轉換位的目前值。

語法

HRESULT GetConvertStg(
  [in] LPSTORAGE pStg
);

參數

[in] pStg

要從中擷取轉換位之儲存物件的 IStorage 指標。

傳回值

IStorage：：OpenStream、 IStorage：：OpenStorage 和 ISequentialStream：：讀取 記憶體和串流存取錯誤。

備註

GetConvertStg 函式是由支援將物件從一種格式轉換成另一種格式的物件伺服器所呼叫。 伺服器必須使用先前類別識別碼的格式讀取記憶體物件， (CLSID) ，並使用新 CLSID 的格式來寫入物件，以支援對象的轉換。 例如，一個應用程式所建立的電子錶格可以轉換成不同應用程式所使用的格式。

轉換位是由 對 SetConvertStg 函式的呼叫所設定。 容器應用程式可以在使用者的要求上呼叫此函式，或者安裝程式可以在安裝新版本的應用程式時呼叫它。 終端使用者會透過 [ 轉換至 ] 對話方塊要求轉換物件。 轉換物件時，新的 CLSID 會永久指派給物件，因此對象隨後會與新的 CLSID 相關聯。

然後，當對象啟動時，其伺服器會呼叫 GetConvertStg 函式，以從記憶體物件擷取轉換位的值。 如果設定位，物件的CLSID已經變更，而且伺服器必須讀取舊格式，並寫入記憶體物件的新格式。

擷取位值之後，物件應用程式應該呼叫 SetConvertStg 函式並將其 fConvert 參數設定為 FALSE 來清除轉換位。

規格需求

另請參閱

SetConvertStg