IExplorerCommandState::GetState-Methode (shobjidl_core.h)

Artikel
03/06/2024

Ruft den Befehlsstatus ab, der einem angegebenen Shellelement zugeordnet ist.

Syntax

HRESULT GetState(
  [in]  IShellItemArray *psiItemArray,
  [in]  BOOL            fOkToBeSlow,
  [out] EXPCMDSTATE     *pCmdState
);

Parameter

[in] psiItemArray

Typ: IShellItemArray*

Ein Zeiger auf ein IShellItemArray mit einem einzelnen Element, das das Shell-Element darstellt.

[in] fOkToBeSlow

Typ: BOOL

FALSE , wenn ein Verbobjekt keine speicherintensiven Berechnungen ausführen soll, die dazu führen können, dass der UI-Thread nicht mehr reagiert. Das Verb-Objekt sollte in diesem Fall E_PENDING zurückgeben. Wenn TRUE, können diese Berechnungen abgeschlossen werden.

[out] pCmdState

Typ: EXPCMDSTATE*

Ein Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Methode einen oder mehrere Windows Explorer-Befehlszustände empfängt, die von den EXPCMDSTATE-Konstanten angegeben werden.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Methode bietet die gleiche Funktionalität wie GetState. Verwenden Sie IExplorerCommandState , wenn Sie nur den Befehlsstatus kennen müssen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)

Freigeben über