IAzClientContext3：：GetGroups 方法 (azroles.h)

GetGroups 方法會傳回與此用戶端內容相關聯的應用程式群組陣列。

語法

HRESULT GetGroups(
  [in]  BSTR    bstrScopeName,
  [in]  ULONG   ulOptions,
  [out] VARIANT *pGroupArray
);

[in] bstrScopeName

要在其中檢查應用程式群組的範圍名稱。如果 ulOptions 參數的值設定為 AZ_CLIENT_CONTEXT_GET_GROUPS_STORE_LEVEL_ONLY，則會忽略此參數。

[in] ulOptions

一組旗標，可修改這個方法的行為。這可以是零或下列一或多個值的組合。

值	意義
AZ_CLIENT_CONTEXT_GET_GROUPS_STORE_LEVEL_ONLY 0x2	這個方法只會檢查存放區層級的應用程式群組。

[out] pGroupArray

與這個用戶端內容相關聯之應用程式群組名稱數位的指標。

這是包含 SAFEARRAY 或 JScript Array 物件的變體。陣列的每個元素都會保留包含應用程式群組名稱 的VT_BSTR 。

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

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