Funzione MIMEAssociationDialogA (intshcut.h)

Articolo
11/20/2024

Esegue la finestra di dialogo Tipo di contenuto MIME non registrato.

Nota Windows XP Service Pack 2 (SP2) o versione successiva: questa funzione non è più supportata.

Sintassi

INTSHCUTAPI HRESULT MIMEAssociationDialogA(
        HWND  hwndParent,
        DWORD dwInFlags,
        PCSTR pcszFile,
        PCSTR pcszMIMEContentType,
  [out] PSTR  pszAppBuf,
        UINT  ucAppBufLen
);

Parametri

hwndParent

Tipo: HWND

Handle per la finestra padre di tutte le finestre figlio pubblicate.

dwInFlags

Tipo: DWORD

Valore del flag di bit che specifica se deve essere registrata un'associazione. Il flag di bit è il valore MIMEASSOCDLG_FL_REGISTER_ASSOC (0x0001). Se questo bit è impostato, l'applicazione selezionata viene registrata come gestore per il tipo MIME specificato. Se questo bit è chiaro, non viene registrata alcuna associazione.

Un'applicazione viene registrata solo se questo flag è impostato e l'utente indica che deve essere effettuata un'associazione permanente.

La registrazione è impossibile se la stringa in pcszFile non contiene un'estensione.

pcszFile

Tipo: PCTSTR

Indirizzo di una stringa con terminazione Null contenente il nome del file di destinazione. Questo file deve essere conforme al tipo di contenuto descritto dal parametro pcszMIMEContentType.

pcszMIMEContentType

Tipo: PCTSTR

Indirizzo di una stringa con terminazione Null contenente il tipo di contenuto non registrato.

[out] pszAppBuf

Tipo: PTSTR

Puntatore a un buffer che, quando questa funzione viene restituita correttamente, riceve il percorso dell'applicazione specificata dall'utente.

ucAppBufLen

Tipo: UINT

Dimensioni di pszAppBuf, in caratteri.

Valore restituito

Tipo: HRESULT

Nota A partire da Windows XP SP2, questa funzione non è supportata e restituisce E_NOTIMPL in tutte le situazioni.

Nei sistemi supportati restituisce S_OK se il tipo di contenuto è stato associato correttamente all'estensione. In questo caso, l'estensione è associata come predefinita per il tipo di contenuto e pszAppBuf punta alla stringa che contiene il percorso dell'applicazione specificata. La funzione restituisce S_FALSE se non è stato registrato alcun elemento. In caso contrario, il valore restituito sarà uno dei seguenti:

Codice restituito	Descrizione
E_ABORT	L'utente ha annullato l'operazione.
E_FLAGS	La combinazione di flag passata in dwInFlags non è valida.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
E_POINTER	Uno dei puntatori di input non è valido.

Osservazioni

Questa funzione non convalida la sintassi della stringa del tipo di contenuto di input in pcszMIMEContentType. Un valore restituito con esito positivo non indica che il tipo di contenuto MIME specificato è valido.

Nota

L'intestazione intshcut.h definisce MIMEAssociationDialog come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	intshcut.h
dll	Url.dll

Condividi tramite