IShellService::SetOwner-Methode (shdeprecated.h)

Veraltet. Deklariert einen Besitzerverweis auf das Dienstobjekt.

Syntax

HRESULT SetOwner(
  IUnknown *punkOwner
);

Parameter

punkOwner

Typ: IUnknown*

Die Adresse eines Schnittstellenzeigers auf das Besitzerobjekt. Wenn NULL, sollte das Objekt IUnknown::Release aufrufen, um den vorhandenen Verweis freizugeben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Client ruft CoCreateInstance für IShellService und dann SetOwner(this) auf, um den Besitz zu deklarieren. Wenn der Client geschlossen wird, in der Regel beim Schließen des Fensters, ruft er SetOwner(NULL) auf, um das Dienstobjekt anzuweisen, den Verweis auf das Besitzerobjekt freizugeben.

Anforderungen

Zielplattform	Windows
Kopfzeile	shdeprecated.h