IPart::GetControlInterface-Methode (devicetopology.h)
Die GetControlInterface-Methode ruft einen Verweis auf die angegebene Steuerelementschnittstelle ab, wenn diese von diesem Teil unterstützt wird.
Syntax
HRESULT GetControlInterface(
[in] UINT nIndex,
[out] IControlInterface **ppInterfaceDesc
);
Parameter
[in] nIndex
Die Steuerschnittstellennummer. Wenn ein Teil n Steuerschnittstellen unterstützt, werden die Steuerschnittstellen von 0 bis n– 1 nummeriert.
[out] ppInterfaceDesc
Zeiger auf eine Zeigervariable, in die die Methode die Adresse der IControlInterface-Schnittstelle der angegebenen Audiofunktion schreibt. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. Der Aufrufer ist für die Freigabe der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem er die Release-Methode der Schnittstelle aufruft. Wenn der GetControlInterface-Aufruf fehlschlägt, ist *ppFunctionNULL.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Zeiger ppFunction ist NULL. |
|
Parameter nIndex liegt außerhalb des Bereichs. |
|
Das Teil verfügt nicht über eine Steuerungsschnittstelle. |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | devicetopology.h |