IPersistStream::GetSizeMax-Methode (objidl.h)

  • Artikel

Ruft die Größe des Datenstroms ab, der zum Speichern des Objekts erforderlich ist.

Syntax

HRESULT GetSizeMax(
  [out] ULARGE_INTEGER *pcbSize
);

Parameter

[out] pcbSize

Die Größe des Datenstroms in Bytes, der zum Speichern dieses Objekts benötigt wird, in Bytes.

Rückgabewert

Diese Methode gibt S_OK zurück, um anzugeben, dass die Größe erfolgreich abgerufen wurde.

Hinweise

Diese Methode gibt die zum Speichern eines Objekts erforderliche Größe zurück. Sie können diese Methode aufrufen, um die Größe zu bestimmen und die erforderlichen Puffer festzulegen, bevor Sie die IPersistStream::Save-Methode aufrufen.

Hinweise für Implementierer

Die GetSizeMax-Implementierung sollte eine konservative Schätzung der erforderlichen Größe zurückgeben, da der Aufrufer die IPersistStream::Save-Methode mit einem nicht anwachsenden Datenstrom aufrufen kann.

URL-Moniker-Hinweise

Diese Methode ruft die maximale Anzahl von Bytes im Stream ab, die für einen nachfolgenden Aufruf von IPersistStream::Save erforderlich ist. Dieser Wert ist sizeof(ULONG)==4 plus sizeof(WCHAR)*n, wobei n die Länge der vollständigen oder partiellen URL-Zeichenfolge ist, einschließlich des NULL-Abschlusszeichens.

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 objidl.h

Weitere Informationen

Ipersiststream