Netbios 関数 (nb30.h)
[Netbios は、Windows Vista、Windows Server 2008、およびそれ以降のバージョンのオペレーティング システムではサポートされていません]
Netbios 関数は、指定されたネットワーク制御ブロック (NCB) を解釈して実行します。
Netbios 関数は、主に NetBIOS インターフェイス用に記述され、Windows に移植する必要があるアプリケーション用に提供されます。 NetBIOS との互換性を必要としないアプリケーションでは、NetBIOS でサポートされているものと同様のタスクを実行するために、Windows ソケット、メールスロット、名前付きパイプ、RPC、分散 COM などの他のインターフェイスを使用する必要があります。 これらの他のインターフェイスは、より柔軟で移植可能です。
構文
UCHAR Netbios(
PNCB pncb
);
パラメーター
pncb
ネットワーク制御ブロックを記述する NCB 構造体へのポインター。
戻り値
同期要求の場合、戻り値は NCB 構造体の戻りコードです。 その値は、NCB 構造体の ncb_retcode メンバーでも返されます。
非同期要求の場合は、次の可能性があります。
- Netbios が呼び出し元に戻るときに非同期コマンドが既に完了している場合、戻り値は、同期 NCB 構造体の場合と同様に、NCB 構造体の戻りコードになります。
- Netbios が呼び出し元に戻ったときに非同期コマンドがまだ保留中の場合、戻り値は 0 になります。
NCB 構造体のncb_length メンバーで指定されたバッファー長が正しくない場合、または ncb_retcode メンバーで指定されたバッファーが書き込み操作から保護されている場合、戻り値はNRC_BUFLEN。
注釈
非同期ネットワーク制御ブロックが終了し、 ncb_post メンバーが 0 以外の場合、 ncb_post で指定されたルーチンが 1 つのパラメーターで呼び出されます。 このパラメーターには、ネットワーク制御ブロックである NCB 構造体へのポインターが含まれています。
NCB 構造体には、イベント (ncb_event メンバー) のハンドルが含まれています。 システムは、非同期 NetBIOS コマンドが受け入れられるときにイベントを非署名状態に設定し、非同期 NetBIOS コマンドの完了時にイベントをシグナル状態に設定します。 同期には、手動リセット イベントのみを使用する必要があります。 指定したイベントは、複数のアクティブな非同期 NetBIOS コマンドに関連付けてはなりません。
ncb_eventを使用して非同期要求を送信する場合は、ncb_postを使用するよりも少ないシステム リソースが必要です。 また、 ncb_event が 0 以外の場合、要求が処理される前にスレッドが終了すると、保留中の要求は取り消されます。 これは、ncb_postを使用して送信された要求 には当てはまらない。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | nb30.h |
Library | Netapi32.lib |
[DLL] | Netapi32.dll |