OPENASINFO 結構 (shlobj_core.h)

發行項
03/15/2023

儲存 SHOpenWithDialog 函式的資訊。

語法

typedef struct _openasinfo {
  LPCWSTR            pcszFile;
  LPCWSTR            pcszClass;
  OPEN_AS_INFO_FLAGS oaifInFlags;
} OPENASINFO, *POPENASINFO;

成員

pcszFile

類型： LPCWSTR

檔案名的指標。

pcszClass

類型： LPCWSTR

檔案類型描述的指標。將此參數設定為 Null ，以使用 pcszFile的副檔名。

oaifInFlags

類型： OPEN_AS_INFO_FLAGS

SHOpenWithDialog對話方塊的特性。下列一或多個值。

OAIF_ALLOW_REGISTRATION (0x00000001)

啟用 [永遠使用此程式] 核取方塊。如果未傳遞，將會停用它。

OAIF_REGISTER_EXT (0x00000002)

在使用者按下 [ 確定 ] 按鈕之後進行註冊。

OAIF_EXEC (0x00000004)

註冊之後執行檔案。

OAIF_FORCE_REGISTRATION (0x00000008)

強制核取 [永遠使用此程式 ] 核取方塊。一般而言，當您傳遞此值時，不會使用 OAIF_ALLOW_REGISTRATION 旗標。

OAIF_HIDE_REGISTRATION (0x00000020)

在 Windows Vista 中引進。隱藏 [ 永遠使用此程式 ] 核取方塊。如果指定此旗標，則會忽略OAIF_ALLOW_REGISTRATION和OAIF_FORCE_REGISTRATION旗標。

OAIF_URL_PROTOCOL (0x00000040)

在 Windows Vista 中引進。傳遞的延伸模組值實際上是通訊協定，因此 [ 開啟方式 ] 對話方塊應該會顯示已註冊為能夠處理該通訊協定的應用程式。

OAIF_FILE_IS_URI (0x00000080)

在 Windows 8 中引進。 pcszFile參數所指向的位置會指定為 URI。

備註

從 Windows 10 開始，SHOpenWithDialog將會忽略OAIF_ALLOW_REGISTRATION、OAIF_FORCE_REGISTRATION和OAIF_HIDE_REGISTRATION旗標。 [ 開啟方式 ] 對話方塊無法再用來變更用來開啟副檔名的預設程式。您只能使用 SHOpenWithDialog 開啟單一檔案。

規格需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	shlobj_core.h (包含 Shlobj.h)

共用方式為