IOleDocument::GetDocMiscStatus-Methode (docobj.h)

Ruft status Informationen zum Dokumentobjekt ab.

Syntax

HRESULT GetDocMiscStatus(
  [out] DWORD *pdwStatus
);

Parameter

[out] pdwStatus

Ein Zeiger auf die Informationen zu unterstützten Verhaltensweisen. Mögliche Werte werden der DOCMISC-Enumeration entnommen.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_POINTER	Die Adresse in pdwStatus ist NULL.

Hinweise

Mit dieser Methode können Container ermitteln, ob ein Dokumentobjekt mehrere Ansichten, komplexe Rechtecke, das Öffnen in einem Popupfenster oder Lese-/Schreibzugriff von Dateien unterstützt.

Werte aus diesem Enumerator werden auch in der Registrierung als Wert des DocObject-Schlüssels gespeichert.

Hinweise für Anrufer

Durch Aufrufen dieser Methode vor der Aktivierung eines Dokumentobjekts können Container alle erforderlichen Schritte ausführen, um das angegebene Verhalten zu unterstützen oder anderweitig zu berücksichtigen.

Hinweise zu Implementierern

Diese Methode muss vollständig in jedem Dokumentobjekt implementiert werden, auch wenn der abgeleitete Wert von pdwStatus 0 ist. E_NOTIMPL ist kein zulässiger Rückgabewert. Normalerweise sollte der zurückgegebene DOCMISC-Wert für die Leistung hartcodiert sein.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	docobj.h

Weitere Informationen

DOCMISC

IOleDocument