IWiaDrvItem::UnlinkItemTree-Methode (wiamindr_lh.h)
Die IWiaDrvItem::UnlinkItemTree Methode hebt die Verknüpfung der Treiberelementstruktur auf und gibt alle Elemente in der Struktur frei.
Syntax
HRESULT UnlinkItemTree(
LONG __MIDL__IWiaDrvItem0005
);
Parameter
__MIDL__IWiaDrvItem0005
lFlags [in]
Gibt an, wie die Treiberelementstruktur nicht verknüpft werden soll. Dieser Parameter muss auf einen der folgenden Werte festgelegt werden.
| Wert | Beschreibung |
|---|---|
| WiaItemTypeDeleted | Das Element wird als aus der Struktur gelöscht markiert. |
| WiaItemTypeDisconnected | Das Element stellt ein getrenntes Gerät dar. |
Weitere Informationen finden Sie unter WIA Item Type Flags.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OKzurückgegeben. Wenn die Methode für ein nichtroot-Element aufgerufen wird, wird E_INVALIDARGzurückgegeben. Wenn die Methode aus einem anderen Grund fehlschlägt, wird ein standardmäßiger COM-Fehlercode zurückgegeben.
Bemerkungen
Minidriver müssen diese Methode für das Stammelement in der Treiberelementstruktur aufrufen, wenn sie die Struktur ungültig machen möchten. Dies geschieht in der Regel, wenn der Treiber entladen wird oder wenn der Minidriver die Treiberelementstruktur neu erstellen muss.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | wiamindr_lh.h (include Wiamindr.h) |