Compartilhar via


Método Application.GetGroupApplicationGroup

Obtém uma conta Microsoft Windows NT Domain\Group associado com um definição de aplicativo corporação GRUPO.

Espaço para nome Microsoft.SharePoint.Portal.SingleSignon
Conjunto de Módulos (Assembly) Microsoft.SharePoint.Portal.SingleSignon (em microsoft.sharepoint.portal.singlesignon.dll)

A sintaxe

<SingleSignonPermissionAttribute(SecurityAction.Demand, Access:=SingleSignonAccess.Minimal)> _
Public Shared Sub GetGroupApplicationGroup ( _
    strApplicationName As String, _
    ByRef strGroupName As String _
)

Dim strApplicationName As String
Dim strGroupName As String

Application.GetGroupApplicationGroup(strApplicationName, strGroupName)
[SingleSignonPermissionAttribute(SecurityAction.Demand, Access=SingleSignonAccess.Minimal)] 
public static void GetGroupApplicationGroup (
    string strApplicationName,
    ref string strGroupName
)

Parâmetros

  • strApplicationName
    O nome do definição de aplicativo a corporação associado com este nome conta NT Domain\Group Domain\Group.Isso não é a nome amigável definição de aplicativo corporação.O número máximo de caracteres permitidos é 128.
  • strGroupName
    O nome GRUPO de SSO.

Comentários

Serviço Microsoft Single Sign-On (SSOSrv) tem dois tipos corporação definição de aplicativo: GRUPO aplicativo e individual aplicativo.Use o GetGroupApplicationGroup GetGroupApplicationGroup método para o tipo aplicativo GRUPO.Se o nome especificado definição de aplicativo não é um aplicativo GRUPO, será retornado um erro de aplicativo não encontrado.Se o nome especificado definição de aplicativo é um aplicativo GRUPO, mas as credenciais não forem definidas, NULL é retornado.

Somente um membro de GRUPO única administração sign-on ou Gerenciador um aplicativo pode usar o GetGroupApplicationGroup método GetGroupApplicationGroup.

O resultado da cada chamar para o GetGroupApplicationGroup GetGroupApplicationGroup método é auditado e armazenado em banco de dados de sign-on único.A enumeração ServiceAction ServiceAction registrada é GetApplication.

Exemplo

O seguinte mostra como usar o GetGroupApplicationGroup método GetGroupApplicationGroup exemplo de código.Para usar esse exemplo, substituir domain_name\\group_name com um válido domínio e GRUPO em sua rede.

using System;
using Microsoft.SharePoint.Portal.SingleSignon;

namespace SSOSampleCode
{
/// <summary>
/// Sample code for SharePoint Portal Single SignOn.
/// </summary>
class CMainEntry
{
            [STAThread]
            static void Main(string[] args)
            {
                try
                {
                    //Create the application fields (max 5 fields).
                    Application.ApplicationField[] rgFields = new Application.ApplicationField[5];

                    rgFields[0] = new Application.ApplicationField(
                        "Field1 Label",  //Application field name
                        true);           //true == mask in the UI, false == don't mask in the UI

                    rgFields[1] = new Application.ApplicationField(
                        "Field2 Label",
                        false);

                    rgFields[2] = new Application.ApplicationField(
                        "Field3 Label",
                        true);

                    rgFields[3] = new Application.ApplicationField(
                        "Field4 Label",
                        false);

                    rgFields[4] = new Application.ApplicationField(
                        "Field5 Label",
                        true);

                    //Create group application information data.
                    Application.ApplicationInfo App = new Application.ApplicationInfo(
                        "MyGroupApplicationID",
                        "My Group Applicaiton Display Name",
                        Application.ApplicationType.Group,
                        "someone@someplace.someext");
                    //Now, add the application
                    Application.AddApplication(
                        App,
                        rgFields,
                        Application.ApplicationCreationDisposition.CreateNew);

                    Console.WriteLine("Successfully added the group application!");

                    //Next, add credentials for this group application.
                    string[] rgCredentialsData = new string[5];

                    rgCredentialsData[0] = "Data for field1";
                    rgCredentialsData[1] = "Data for field2";
                    rgCredentialsData[2] = "Data for field3";
                    rgCredentialsData[3] = "Data for field4";
                    rgCredentialsData[4] = "Data for field5";

                    Credentials.SetGroupCredentials(
                        "MyGroupApplicationID",
                        "domain_name\\group_name",
                        rgCredentialsData);
                    Console.WriteLine("Successfully added credentials to the group application");

                    //Get the group applications associated group account name.
                    string strGroupName = null;
                    Application.GetGroupApplicationGroup(
                        "MyGroupApplicationID",
                        ref strGroupName);

                    Console.WriteLine("Group account associated with this application is: " + strGroupName);
                }
                catch (SingleSignonException esso)
                {
                    Console.WriteLine("SingleSignonException caught.");
                    Console.WriteLine("Exception Code: " + "0x" + esso.LastErrorCode.ToString("x"));
                    Console.WriteLine("Source: " + esso.Source);
                    Console.WriteLine("StackTrace: " + esso.StackTrace);
                    Console.WriteLine("MethodName: " + esso.TargetSite.Name);
                    Console.WriteLine("Message: " + esso.Message);
                }
                catch (Exception e)
                {
                    Console.WriteLine("Exception caught.");
                    Console.WriteLine("Source: " + e.Source);
                    Console.WriteLine("StackTrace: " + e.StackTrace);
                    Console.WriteLine("MethodName: " + e.TargetSite.Name);
                    Console.WriteLine("Message: " + e.Message);
                }
            }
    }
}

Consulte também

Referência

Application De classe
Application Membros
Microsoft.SharePoint.Portal.SingleSignon De espaço para nome