SnmpOidCopy 関数 (winsnmp.h)
[SNMP は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、WS-Man の Microsoft 実装である Windows リモート管理を使用します。
WinSNMP SnmpOidCopy 関数は SNMP オブジェクト識別子をコピーし、コピーに必要なメモリを割り当てる。
構文
SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCopy(
[in] smiLPCOID srcOID,
[out] smiLPOID dstOID
);
パラメーター
[in] srcOID
コピーする smiOID 構造体へのポインター。
[out] dstOID
srcOID パラメーターで指定されたオブジェクト識別子のコピーを受け取る smiOID 構造体へのポインター。
戻り値
関数が成功した場合、戻り値はコピーされたオブジェクト識別子内のサブ識別子の数です。 この数値は、dstOID パラメーターが指す smiOID 構造体の len メンバーの値でもあります。
関数が失敗した場合、戻り値はSNMPAPI_FAILURE。 拡張エラー情報を取得するには、セッション パラメーターに NULL 値を指定して SnmpGetLastError を呼び出します。 SnmpGetLastError 関数は、次のいずれかのエラーを返すことができます。
| リターン コード | 説明 |
|---|---|
|
SnmpStartup 関数が正常に完了しませんでした。 |
|
メモリ割り当て中にエラーが発生しました。 |
|
srcOID パラメーターが無効です。 |
|
不明または未定義のエラーが発生しました。 |
解説
入力時に、SnmpOidCopy 関数は dstOID パラメーターが指す smiOID 構造体のメンバーを無視します。 関数が正常に完了すると、Microsoft WinSNMP 実装によって smiOID メンバーが上書きされます。
WinSNMP アプリケーションは、snmpFreeDescriptor 関数を呼び出して、dstOID パラメーターが指す smiOID 構造体の ptr メンバーに割り当てられたリソースを解放できるように実装する必要があります。 詳細については、「WinSNMP データ管理の概念」および「WinSNMP 記述子の解放」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winsnmp.h |
| Library | Wsnmp32.lib |
| [DLL] | Wsnmp32.dll |