MprAdminTransportSetInfo 関数 (mprapi.h)
MprAdminTransportSetInfo 関数は、指定されたトランスポートのグローバル情報または既定のクライアント インターフェイス情報、またはその両方を設定します。
構文
DWORD MprAdminTransportSetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] DWORD dwTransportId,
[in, optional] LPBYTE pGlobalInfo,
[in] DWORD dwGlobalInfoSize,
[in, optional] LPBYTE pClientInterfaceInfo,
[in] DWORD dwClientInterfaceInfoSize
);
パラメーター
[in] hMprServer
情報が設定されているルーターを処理します。 このハンドルは、 MprAdminServerConnect の以前の呼び出しから取得されます。
[in] dwTransportId
設定するトランスポートの種類を表す DWORD 値。 dwTransportId に使用できる値を次の表に示します。
| 値 | トランスポート (プロトコル ファミリ) |
|---|---|
| PID_ATALK | Appletalk |
| PID_IP | インターネット プロトコル バージョン 4 |
| PID_IPX | インターネット パケット交換 |
| PID_NBF | NetBIOS フレーム プロトコル |
| PID_IPV6 | Windows Server 2008 以降: インターネット プロトコル バージョン 6 |
[in, optional] pGlobalInfo
トランスポートのグローバル情報を指定するバッファーへのポインター。 情報ヘッダー関数を使用して、情報ヘッダーを操作します。
このパラメーターは省略可能です。 呼び出し元のアプリケーションでこのパラメーターに NULL が 指定されている場合、関数はグローバル情報を設定しません。
[in] dwGlobalInfoSize
pGlobalInfo パラメーターが指すバッファーのサイズをバイト単位で指定します。
[in, optional] pClientInterfaceInfo
トランスポートの既定のクライアント インターフェイス情報を指定するバッファーへのポインター。
このパラメーターは省略可能です。 呼び出し元のアプリケーションがこのパラメーターに NULL を 指定した場合、関数は既定のクライアント インターフェイス情報を設定しません。
[in] dwClientInterfaceInfoSize
pClientInterfaceInfo パラメーターによって指されるバッファーのサイズをバイト単位で指定します。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| 値 | 説明 |
|---|---|
|
呼び出し元のアプリケーションに十分な特権がありません。 |
|
pGlobalInfo パラメーターと pClientInterfaceInfo パラメーターはどちらも NULL です。 |
|
操作を完了するためのリソースが不足しています。 |
|
dwTransportId 値は、サポートされているトランスポート プロトコルと一致しません。 |
要件
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mprapi.h |
| Library | Mprapi.lib |
| [DLL] | Mprapi.dll |