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が返されます。 それ以外の場合は、次のいずれかのエラー コードが返されます。

Requirements