共用方式為

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 所傳回的相同。 如果輸入資源語法具有父系，提供者可以傳回它，而不需要判斷輸入資源或其父系是否確實存在。 如果資源在網路上沒有瀏覽父代，則會以 NULL 的形式傳回 lpRemoteName。

傳回 dwUsage 字段中的RESOURCEUSAGE_CONNECTABLE位不一定表示資源目前可以連線，只有資源可在網路上使用時才能連線。

[in, out] lpBufferSize

指定 lpBuffer 參數所指向之緩衝區大小的位元組位置指標。 如果緩衝區對結果而言太小，函式會將所需的緩衝區大小放在這個位置，並傳回錯誤WN_MORE_DATA。

傳回值

如果函式成功，它應該會傳回WN_SUCCESS。 否則，它應該會傳回錯誤碼，可能是下列其中一項。

傳回碼 Description
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