OPENASINFO 結構 (shlobj_core.h)

儲存 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_REGISTRATIONOAIF_FORCE_REGISTRATIONOAIF_HIDE_REGISTRATION旗標。 [ 開啟方式 ] 對話方塊無法再用來變更用來開啟副檔名的預設程式。 您只能使用 SHOpenWithDialog 開啟單一檔案。

規格需求

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