Funzione OleUIObjectPropertiesA (oledlg.h)

Articolo
03/05/2024

Richiama la finestra di dialogo Proprietà oggetto , che visualizza informazioni generali, visualizzazione e collegamento su un oggetto.

Sintassi

UINT OleUIObjectPropertiesA(
  [in] LPOLEUIOBJECTPROPSA unnamedParam1
);

Parametri

[in] unnamedParam1

Puntatore alla struttura OLEUIOBJECTPROPS .

Valore restituito

Definizioni di errori/esito positivo standard

Codice restituito	Descrizione
OLEUI_FALSE	Errore sconosciuto (inutilizzato).
OLEUI_OK	L'utente ha premuto il pulsante OK .
OLEUI_SUCCESS	Nessun errore, uguale a 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 era 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	Impossibile inizializzare la finestra di dialogo.
OLEUI_ERR_LOCALMEMALLOC	Una chiamata a LocalAlloc o all'allocatore IMalloc standard non è riuscita.
OLEUI_ERR_GLOBALMEMALLOC	Una chiamata a GlobalAlloc o all'allocatore IMalloc standard non è riuscita.
OLEUI_ERR_LOADSTRING	Impossibile chiamare LoadString per le risorse localizzate dalla libreria.
OLEUI_ERR_OLEMEMALLOC	Una 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_OPERR_SUBPROPNULL	lpGP o lpVP è NULL o dwFlags e OPF_OBJECTISLINK e lpLP sono NULL.
OLEUI_OPERR_SUBPROPINVALID	Autorizzazioni di accesso in scrittura insufficienti per le strutture a cui fa riferimento lpGP, lpVP o lpLP.
OLEUI_OPERR_PROPSHEETNULL	Il valore lpLP è NULL.
OLEUI_OPERR_PROPSHEETINVALID	Autorizzazioni di accesso in scrittura insufficienti per le strutture a cui fa riferimento lpGP, lpVP o lpLP.
OLEUI_OPERR_SUPPROP	Il puntatore della proprietà sub-link, lpLP, è NULL.
OLEUI_OPERR_PROPSINVALID	Accesso in scrittura insufficiente per il puntatore della proprietà sub-link, lpLP.
OLEUI_OPERR_PAGESINCORRECT	Alcune proprietà del collegamento secondario del membro lpPS non sono corrette.
OLEUI_OPERR_INVALIDPAGES	Alcune proprietà del collegamento secondario del membro lpPS non sono corrette.
OLEUI_OPERR_NOTSUPPORTED	Una proprietà di collegamento secondario del membro lpPS non è corretta.
OLEUI_OPERR_DLGPROCNOTNULL	Una proprietà di collegamento secondario del membro lpPS non è corretta.
OLEUI_OPERR_LPARAMNOTZERO	Una proprietà di collegamento secondario del membro lpPS non è corretta.
OLEUI_GPERR_STRINGINVALID	Un valore stringa ,ad esempio lplpszLabel o lplpszType, non è valido.
OLEUI_GPERR_CLASSIDINVALID	Il valore clsid non è valido.
OLEUI_GPERR_LPCLSIDEXCLUDEINVALID	Il valore ClsidExcluded non è valido.
OLEUI_GPERR_CBFORMATINVALID	Il valore wFormat non è valido.
OLEUI_VPERR_METAPICTINVALID	Il valore hMetaPict non è valido.
OLEUI_VPERR_DVASPECTINVALID	Il valore dvAspect non è valido.
OLEUI_OPERR_PROPERTYSHEET	Il valore lpPS non è corretto.
OLEUI_OPERR_OBJINFOINVALID	Il valore lpObjInfo è NULL o il processo di chiamata non ha accesso in lettura.
OLEUI_OPERR_LINKINFOINVALID	Il valore lpLinkInfo è NULL o il processo chiamante non ha accesso in lettura.

Commenti

OleUIObjectProperties viene passata una struttura OLEUIOBJECTPROPS , che fornisce le informazioni necessarie per compilare le schede Generale, Visualizzazione e Collegamento della finestra di dialogo Proprietà oggetto .

Nota

L'intestazione oledlg.h definisce OleUIObjectProperties come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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