MprAdminTransportCreate 関数 (mprapi.h)
MprAdminTransportCreate 関数は、新しいトランスポートを読み込み、トランスポートのルーター マネージャーを開始します。
構文
DWORD MprAdminTransportCreate(
[in] MPR_SERVER_HANDLE hMprServer,
[in] DWORD dwTransportId,
[in, optional] LPWSTR lpwsTransportName,
[in] LPBYTE pGlobalInfo,
[in] DWORD dwGlobalInfoSize,
[in, optional] LPBYTE pClientInterfaceInfo,
[in, optional] DWORD dwClientInterfaceInfoSize,
[in] LPWSTR lpwsDLLPath
);
パラメーター
[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] lpwsTransportName
トランスポートの名前を指定する null で終わる Unicode 文字列へのポインター。
[in] pGlobalInfo
トランスポートのグローバル情報を指定するバッファーへのポインター。 情報ヘッダー関数を使用して、情報ヘッダーを操作します。
[in] dwGlobalInfoSize
pGlobalInfo パラメーターによって指されるデータのサイズをバイト単位で指定します。
[in, optional] pClientInterfaceInfo
トランスポートの既定のクライアント インターフェイス情報を指定するバッファーへのポインター。
このパラメーターは省略可能です。 呼び出し元のアプリケーションがこのパラメーターに NULL を 指定した場合、関数は既定のクライアント インターフェイス情報を設定しません。
[in, optional] dwClientInterfaceInfoSize
pClientInterfaceInfo パラメーターによって指されるバッファーのサイズをバイト単位で指定します。
[in] lpwsDLLPath
トランスポートの DLL へのパスを指定する null で終わる Unicode 文字列へのポインター。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| 値 | 意味 |
|---|---|
|
呼び出し元のアプリケーションに十分な特権がありません。 |
|
pGlobalInfo パラメーターと pClientInterfaceInfo パラメーターはどちらも NULL です。 |
|
操作を完了するためのリソースが不足しています。 |
|
指定したトランスポートは、指定されたルーターで既に実行されています。 |
|
dwTransportId 値は、サポートされているトランスポート プロトコルと一致しません。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mprapi.h |
| Library | Mprapi.lib |
| [DLL] | Mprapi.dll |