Funzione OleUIChangeSourceA (oledlg.h)

Articolo
08/25/2023

Richiama la finestra di dialogo Cambia origine , consentendo all'utente di modificare l'origine di un collegamento.

Sintassi

UINT OleUIChangeSourceA(
  [in] LPOLEUICHANGESOURCEA unnamedParam1
);

Parametri

[in] unnamedParam1

Puntatore alla struttura OLEUICHANGESOURCE in uscita per questa finestra di dialogo.

Valore restituito

Definizioni di esito positivo/errore standard

Codice restituito	Descrizione
OLEUI_FALSE	Errore sconosciuto (inutilizzato).
OLEUI_OK	L'utente ha premuto il pulsante OK.
OLEUI_SUCCESS	Nessun errore, come OLEUI_OK.
OLEUI_CANCEL	L'utente ha premuto il pulsante Annulla.

Errori di convalida dei campi standard

Codice restituito	Descrizione
OLEUI_ERR_STANDARDMIN	Gli errori comuni a tutte le finestre di dialogo si trovano nell'intervallo OLEUI_ERR_STANDARDMIN da OLEUI_ERR_STANDARDMAX. Questo valore consente all'applicazione di testare i messaggi standard per visualizzare i messaggi di errore all'utente.
OLEUI_ERR_STRUCTURENULL	Il puntatore a una struttura OLEUIXXX passata alla funzione è NULL.
OLEUI_ERR_STRUCTUREINVALID	Autorizzazioni insufficienti per l'accesso in lettura o scrittura a una struttura OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT	Il valore cbstruct non è corretto.
OLEUI_ERR_HWNDOWNERINVALID	Il valore hWndOwner non è valido.
OLEUI_ERR_LPSZCAPTIONINVALID	Il valore lpszCaption non è valido.
OLEUI_ERR_LPFNHOOKINVALID	Il valore lpfnHook non è valido.
OLEUI_ERR_HINSTANCEINVALID	Il valore hInstance non è valido.
OLEUI_ERR_LPSZTEMPLATEINVALID	Il valore lpszTemplate non è valido.
OLEUI_ERR_HRESOURCEINVALID	Il valore hResource non è valido.

Errori di inizializzazione

Codice restituito	Descrizione
OLEUI_ERR_FINDTEMPLATEFAILURE	Impossibile trovare il modello della finestra di dialogo.
OLEUI_ERR_LOADTEMPLATEFAILURE	Impossibile caricare il modello della finestra di dialogo.
OLEUI_ERR_DIALOGFAILURE	Inizializzazione della finestra di dialogo non riuscita.
OLEUI_ERR_LOCALMEMALLOC	Chiamata a LocalAlloc o allocatore IMalloc standard non riuscita.
OLEUI_ERR_GLOBALMEMALLOC	Chiamata a GlobalAlloc o allocatore IMalloc standard non riuscita.
OLEUI_ERR_LOADSTRING	Impossibile chiamare LoadString per le risorse localizzate dalla libreria.
OLEUI_ERR_OLEMEMALLOC	Chiamata all'allocatore IMalloc standard non riuscita.

Errori specifici della funzione

Codice restituito	Descrizione
OLEUI_ERR_STANDARDMAX	Gli errori comuni a tutte le finestre di dialogo si trovano nell'intervallo OLEUI_ERR_STANDARDMIN da OLEUI_ERR_STANDARDMAX. Questo valore consente all'applicazione di testare i messaggi standard per visualizzare i messaggi di errore all'utente.
OLEUI_CSERR_LINKCNTRNULL	Il valore lpOleUILinkContainer è NULL.
OLEUI_CSERR_LINKCNTRINVALID	Il valore lpOleUILinkContainer non è valido.
OLEUI_CSERR_FROMNOTNULL	Il valore lpszFrom non è NULL.
OLEUI_CSERR_TONOTNULL	Il valore lpszTo non è NULL.
OLEUI_CSERR_SOURCEINVALID	Il valore lpszDisplayName o nFileLength non è valido oppure non può recuperare l'origine del collegamento.
OLEUI_CSERR_SOURCEPARSEERROR	Il valore nFilename non è corretto.

Commenti

L'origine del collegamento non viene modificata dalla finestra di dialogo Cambia origine . Spetta invece al chiamante modificare l'origine del collegamento usando le stringhe di file e elemento restituite. La finestra di dialogo Modifica collegamenti esegue in genere questa operazione per il chiamante.

Nota

L'intestazione oledlg.h definisce OLEUICHANGESOURCE 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oledlg.h
Libreria	OleDlg.lib
DLL	OleDlg.dll

Vedi anche

IOleUILinkContainer

OLEUICHANGESOURCE

OleUIEditLinks

Condividi tramite