Freigeben über


SnmpOidCopy-Funktion (winsnmp.h)

[SNMP ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows-Remoteverwaltung, die Microsoft-Implementierung von WS-Man.]

Die WinSNMP-SnmpOidCopy-Funktion kopiert einen SNMP-Objektbezeichner und weist alle erforderlichen Speicher für die Kopie zu.

Syntax

SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCopy(
  [in]  smiLPCOID srcOID,
  [out] smiLPOID  dstOID
);

Parameter

[in] srcOID

Zeiger auf eine zu kopierende smiOID-Struktur .

[out] dstOID

Zeiger auf eine smiOID-Struktur , um eine Kopie des Objektbezeichners zu empfangen, der durch den srcOID-Parameter angegeben wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der Unteridentifizierer im kopierten Objektbezeichner. Diese Zahl ist auch der Wert des len-Elements der smiOID-Struktur , auf die der dstOID-Parameter verweist.

Wenn die Funktion fehlschlägt, wird der Rückgabewert SNMPAPI_FAILURE. Rufen Sie SnmpGetLastError auf, um erweiterte Fehlerinformationen zu erhalten, und geben Sie einen NULL-Wert im Sitzungsparameter an. Die SnmpGetLastError-Funktion kann einen der folgenden Fehler zurückgeben.

Rückgabecode Beschreibung
SNMPAPI_NOT_INITIALIZED
Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen.
SNMPAPI_ALLOC_ERROR
Während der Speicherbelegung ist ein Fehler aufgetreten.
SNMPAPI_OID_INVALID
Der srcOID-Parameter ist ungültig.
SNMPAPI_OTHER_ERROR
Es ist ein unbekannter oder nicht definierter Fehler aufgetreten.

Hinweise

Bei der Eingabe ignoriert die SnmpOidCopy-Funktion die Member der smiOID-Struktur , auf die der dstOID-Parameter verweist. Die Microsoft WinSNMP-Implementierung überschreibt die smiOID-Member , wenn die Funktion erfolgreich abgeschlossen wird.

Die WinSNMP-Anwendung muss die SnmpFreeDescriptor-Funktion aufrufen, damit die Implementierung Ressourcen freigeben kann, die dem ptr-Member der smiOID-Struktur zugeordnet sind, auf die der dstOID-Parameter verweist. Weitere Informationen finden Sie unter WinSNMP Datenverwaltung Konzepte und Freigeben von WinSNMP-Deskriptoren.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winsnmp.h
Bibliothek Wsnmp32.lib
DLL Wsnmp32.dll

Weitere Informationen

SnmpFreeDescriptor

WinSNMP-Funktionen

Übersicht über winSNMP-API

smiOID