Funzione OleUIChangeSourceA (oledlg.h)
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 |
|---|---|
|
Errore sconosciuto (inutilizzato). |
|
L'utente ha premuto il pulsante OK. |
|
Nessun errore, come OLEUI_OK. |
|
L'utente ha premuto il pulsante Annulla. |
Errori di convalida dei campi standard
| Codice restituito | Descrizione |
|---|---|
|
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. |
|
Il puntatore a una struttura OLEUIXXX passata alla funzione è NULL. |
|
Autorizzazioni insufficienti per l'accesso in lettura o scrittura a una struttura OLEUIXXX. |
|
Il valore cbstruct non è corretto. |
|
Il valore hWndOwner non è valido. |
|
Il valore lpszCaption non è valido. |
|
Il valore lpfnHook non è valido. |
|
Il valore hInstance non è valido. |
|
Il valore lpszTemplate non è valido. |
|
Il valore hResource non è valido. |
Errori di inizializzazione
| Codice restituito | Descrizione |
|---|---|
|
Impossibile trovare il modello della finestra di dialogo. |
|
Impossibile caricare il modello della finestra di dialogo. |
|
Inizializzazione della finestra di dialogo non riuscita. |
|
Chiamata a LocalAlloc o allocatore IMalloc standard non riuscita. |
|
Chiamata a GlobalAlloc o allocatore IMalloc standard non riuscita. |
|
Impossibile chiamare LoadString per le risorse localizzate dalla libreria. |
|
Chiamata all'allocatore IMalloc standard non riuscita. |
Errori specifici della funzione
| Codice restituito | Descrizione |
|---|---|
|
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. |
|
Il valore lpOleUILinkContainer è NULL. |
|
Il valore lpOleUILinkContainer non è valido. |
|
Il valore lpszFrom non è NULL. |
|
Il valore lpszTo non è NULL. |
|
Il valore lpszDisplayName o nFileLength non è valido oppure non può recuperare l'origine del collegamento. |
|
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 |