IAzClientContext2：：GetAssignedScopesPage 方法 (azroles.h)

GetAssignedScopesPage 方法會擷取由目前 IAzClientContext2 物件表示的用戶端指派給至少一個角色的範圍清單。

語法

HRESULT GetAssignedScopesPage(
  [in]      LONG    lOptions,
  [in]      LONG    PageSize,
  [in, out] VARIANT *pvarCursor,
            VARIANT *pvarScopeNames
);

參數

[in] lOptions

旗標，指定這個方法是否檢查LDAP查詢群組是否有範圍指派。 不論此旗標的值為何，都會檢查先前快取的LDAP查詢群組。

[in] PageSize

每個頁面結果中的項目數目。

[in, out] pvarCursor

VARIANT 的指標，表示目前的結果頁面。 若要第一次呼叫 GetAssignedScopesPage 方法，請傳遞 VT_EMPTY 做為此參數的值，以擷取結果的第一頁。 頁面上的項目數目取決於 PageSize 參數的值。 在輸出中，此參數包含要在下一次呼叫 GetAssignedScopesPage 中傳遞的值，以擷取下一頁的結果。 如果輸出上的此參數值為 EMPTY，則沒有任何結果頁面。

pvarScopeNames

傳回時，包含 VARIANT 類型的變數陣列。 陣列的每個元素的類型 為 VT_BSTR ，且包含目前用戶端指派的目標範圍名稱。 陣列中的元素數目是由 PageSize 參數所指定。

傳回值

如果方法成功，方法會傳回S_OK。

如果方法失敗，它會傳回指出錯誤的 HRESULT 值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

備註

如果多個線程存取相同的授權存放區，如果另一個線程修改存放區，則對其中一個線程上的 GetAssignedScopesPage 方法呼叫可能不會傳回精確的結果。

在 JScript 中，傳回 的 SAFEARRAY 值必須轉換成 JScript Array 物件。

規格需求