NPGetResourceParent 関数 (npapi.h)

  • [アーティクル]

参照階層内の指定されたネットワーク リソースの親を取得します。 通常、この関数は、 NPEnumResource または NPGetResourceInformation の以前の呼び出しから同じプロバイダーによって返されたリソースに対して呼び出されます。

構文

DWORD NPGetResourceParent(
  [in]      LPNETRESOURCEW lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpBufferSize
);

パラメーター

[in] lpNetResource

親名が必要なネットワーク リソースへのポインター。 NETRESOURCE は、NPEnumResource または NPGetResourceInformation の以前の呼び出しから取得されたか、呼び出し元によって構築された可能性があります。

lpRemoteName フィールドは、親が必要なネットワーク リソースのリモート名を指定します。

lpProvider フィールドは、呼び出すプロバイダーを指定します。 これは指定する必要があります。

呼び出し元のプログラムがその値を認識している場合は、 dwType フィールドが入力されます。 それ以外の場合は、NULL に設定 されます。

NETRESOURCE 内の他のすべてのフィールドは無視され、初期化されません。

[out] lpBuffer

結果を受け取るバッファーへのポインター。これは、親リソースを表す単一の NETRESOURCE 構造体です。 lpRemoteName、lpProvider、dwType、dwDisplayType、dwUsage フィールドが返されます。他のすべてのフィールドは NULL に設定されます。

出力 lpRemoteName は 、NPEnumResource によって列挙体から返されたものと同じ形式にする必要があります。そのため、呼び出し元は大文字と小文字を区別する文字列比較を実行して、親リソースが NPEnumResource によって返されたものと同じかどうかを判断できます。 入力リソースに構文的に親がある場合、プロバイダーは、入力リソースまたはその親が実際に存在するかどうかを判断せずに、それを返すことができます。 リソースにネットワーク上に参照親がない場合、 lpRemoteName は NULL として返されます。

返された dwUsage フィールドのRESOURCEUSAGE_CONNECTABLE ビットは、リソースが現在接続できることを必ずしも示しているわけではありません。リソースがネットワーク上で使用可能な場合にのみ接続可能です。

[in, out] lpBufferSize

lpBuffer パラメーターが指すバッファーのサイズをバイト単位で指定する場所へのポインター。 バッファーが結果に対して小さすぎる場合、関数は必要なバッファー サイズをこの場所に配置し、エラー WN_MORE_DATAを返します。

戻り値

関数が成功した場合は、WN_SUCCESSを返す必要があります。 それ以外の場合は、次のいずれかのエラー コードを返す必要があります。

リターン コード 説明
WN_MORE_DATA
 入力バッファーが小さすぎます。
WN_BAD_NETNAME
 このプロバイダーは 、lpNetResource で指定されたリソースを所有していません (または、リソースが構文上無効です)。
WN_BAD_VALUE
 dwUsage または dwType が無効であるか、指定されたパラメーターの組み合わせが正しくありません (たとえば、lpRemoteName は dwType に対して構文的に無効です)。
WN_NOT_AUTHENTICATED
 呼び出し元がネットワークに対して認証されていません。
WN_ACCESS_DENIED
 呼び出し元はネットワークに対して認証されていますが、十分なアクセス許可がありません。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー npapi.h