OleUIInsertObjectA-Funktion (oledlg.h)
Ruft das Standarddialogfeld Objekt einfügen auf, in dem der Benutzer eine Objektquelle und einen Klassennamen sowie die Option zum Anzeigen des Objekts als sich selbst oder als Symbol auswählen kann.
Syntax
UINT OleUIInsertObjectA(
[in] LPOLEUIINSERTOBJECTA unnamedParam1
);
Parameter
[in] unnamedParam1
Zeiger auf die in-out OLEUIINSERTOBJECT-Struktur für dieses Dialogfeld.
Rückgabewert
Standarddefinitionen für Erfolg/Fehler
Rückgabecode | Beschreibung |
---|---|
|
Unbekannter Fehler (nicht verwendet). |
|
Der Benutzer hat die Schaltfläche OK gedrückt. |
|
Kein Fehler, wie OLEUI_OK. |
|
Der Benutzer hat die Schaltfläche Abbrechen gedrückt. |
Standardfeldvalidierungsfehler
Rückgabecode | Beschreibung |
---|---|
|
Fehler, die für alle Dialogfelder gemeinsam sind, liegen im Bereich OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX. Mit diesem Wert kann die Anwendung auf Standardmeldungen testen, um dem Benutzer Fehlermeldungen anzuzeigen. |
|
Der Zeiger auf eine OLEUIXXX-Struktur, die an die Funktion übergeben wurde, war NULL. |
|
Unzureichende Berechtigungen für Lese- oder Schreibzugriff auf eine OLEUIXXX-Struktur. |
|
Der cbstruct-Wert ist falsch. |
|
Der hWndOwner-Wert ist ungültig. |
|
Der lpszCaption-Wert ist ungültig. |
|
Der lpfnHook-Wert ist ungültig. |
|
Der hInstance-Wert ist ungültig. |
|
Der lpszTemplate-Wert ist ungültig. |
|
Der hResource-Wert ist ungültig. |
Initialisierungsfehler
Rückgabecode | Beschreibung |
---|---|
|
Die Dialogfeldvorlage konnte nicht gefunden werden. |
|
Die Dialogfeldvorlage kann nicht geladen werden. |
|
Fehler bei der Dialogfeldinitialisierung. |
|
Ein Aufruf von LocalAlloc oder der IMalloc-Standardzuweisung ist fehlgeschlagen. |
|
Fehler beim Aufruf von GlobalAlloc oder der IMalloc-Standardzuweisung . |
|
LoadString für lokalisierte Ressourcen aus der Bibliothek kann nicht aufgerufen werden. |
|
Fehler beim Aufruf der IMalloc-Standardzuweisung . |
Funktionsspezifische Fehler
Rückgabecode | Beschreibung |
---|---|
|
Fehler, die für alle Dialogfelder gemeinsam sind, liegen im Bereich OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX. Mit diesem Wert kann die Anwendung auf Standardmeldungen testen, um dem Benutzer Fehlermeldungen anzuzeigen. |
|
Der LpszFile-Wert ist ungültig, oder der Benutzer verfügt über unzureichende Schreibzugriffsberechtigungen. Dieses lpszFile-Element verweist auf den Namen der Datei, mit der verknüpft oder eingefügt wurde. |
|
Der ppvOjb-Wert ist ungültig. Dieser Member zeigt auf die Position, an der der Zeiger für das Objekt zurückgegeben wird. |
|
Der LpIOleClientSite-Wert ist ungültig. Dieser Member zeigt auf den Clientstandort für das -Objekt. |
|
Der lpIStorage-Wert ist ungültig. Dieser Member verweist auf den Speicher, der für das -Objekt verwendet werden soll. |
|
Das sc-Element von lpIO verfügt über zusätzliche Fehlerinformationen. |
|
Der LpClsidExclude-Wert ist ungültig. Dieses Element enthält die Liste der auszuschließenden CLSIDs. |
|
Der Wert cchFile oder lpszFile ist ungültig. Das cchFile-Element gibt die Größe des lpszFile-Puffers an. Das lpszFile-Element verweist auf den Namen der Datei, mit der verknüpft oder eingefügt wurde. |
Hinweise
OleUIInsertObject ermöglicht es dem Benutzer, den Typ des einzufügenden Objekts aus einem Listenfeld auszuwählen, das die im System des Benutzers registrierten Objektanwendungen enthält. Um dieses Listenfeld aufzufüllen, durchläuft OleUIInsertObject die Registrierung und fügt jeden gefundenen Objektserver hinzu, der die folgenden Kriterien erfüllt:
- Der Registrierungseintrag enthält nicht den Schlüssel NotInsertable.
- Der Registrierungseintrag enthält einen OLE 1.0-Stil Protocol\\StdFileEditing\\Server-Schlüssel.
- Der Registrierungseintrag enthält den einfügbaren Schlüssel.
- Die CLSID des Objekts ist nicht in der Liste der auszuschließenden Objekte enthalten (das lpClsidExclude-Element von OLEUIINSERTOBJECT).
Um eine HMETAFILEPICT freizugeben, die aus dem Dialogfeld Objekt einfügen oder Spezial einfügen zurückgegeben wird, löschen Sie die angefügte Metadatei auf dem Handle wie folgt:
void FreeHmetafilepict(HMETAFILEPICT hmfp)
{
if (hmfp != NULL)
{
LPMETAFILEPICT pmfp = GlobalLock(hmfp);
DeleteMetaFile(pmfp->hMF);
GlobalUnlock(hmfp);
GlobalFree(hmfp);
}
else
{
// Handle null pointers here.
exit(0);
}
}
Hinweis
Der oledlg.h-Header definiert OLEUIINSERTOBJECT als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | oledlg.h |
Bibliothek | OleDlg.lib |
DLL | OleDlg.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für