SnmpDuplicatePdu 関数 (winsnmp.h)

[SNMP は、[要件] セクションで指定したオペレーティングシステムで使用できます。今後のバージョンでは変更されるか、利用できなくなる場合もあります。代わりに、WS-Man の Microsoft 実装である Windows リモート管理を使用します。

WinSNMP SnmpDuplicatePdu 関数は、PDU パラメーターが識別する SNMP プロトコルデータユニット (PDU) を複製し、重複する PDU に必要なメモリを割り当てる。

構文

HSNMP_PDU SNMPAPI_CALL SnmpDuplicatePdu(
  [in] HSNMP_SESSION session,
  [in] HSNMP_PDU     PDU
);

[in] session

WinSNMP セッションを処理します。

[in] PDU

複製する PDU への処理。 SnmpDuplicatePdu 関数は、呼び出し元アプリケーション内の各 PDU に対して一意のハンドルを提供します。

関数が成功した場合、戻り値は新しい重複する PDU を識別するハンドルです。

関数が失敗した場合、戻り値はSNMPAPI_FAILURE。拡張エラー情報を取得するには、 SnmpGetLastError を呼び出します。 SnmpGetLastError 関数は、次のいずれかのエラーを返すことができます。

リターンコード	説明
SNMPAPI_NOT_INITIALIZED	SnmpStartup 関数が正常に完了しませんでした。
SNMPAPI_ALLOC_ERROR	メモリ割り当て中にエラーが発生しました。
SNMPAPI_SESSION_INVALID	セッションハンドルが無効です。
SNMPAPI_PDU_INVALID	PDU ハンドルが無効です。
SNMPAPI_OTHER_ERROR	不明または未定義のエラーが発生しました。

新しい PDU に対して SnmpDuplicatePdu 関数によって割り当てられたリソースを解放するには、WinSNMP アプリケーションで SnmpFreePdu 関数を呼び出す必要があります。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winsnmp.h
Library	Wsnmp32.lib
[DLL]	Wsnmp32.dll