共用方式為

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。 否則，它應該會傳回錯誤碼，這可能是下列其中一項。

回傳碼 Description
WN_MORE_DATA
 輸入緩衝區太小。
WN_BAD_NETNAME
 此提供者不擁有 lpNetResource 所指定的資源 （或資源語法無效） 。
WN_BAD_VALUE
 dwUsage 或 dwType 無效，或指定的參數組合不正確 （例如，lpRemoteName 語法對 dwType 無效） 。
WN_NOT_AUTHENTICATED
 呼叫者尚未通過網路身份驗證。
WN_ACCESS_DENIED
 呼叫者已通過網路身份驗證，但沒有足夠的許可權。

需求

Requirement 價值觀
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
Header npapi.h
Library davclnt.lib
  • Last updated on